---

name: mcp-tools-catalog description: Build docs/mcp-tools.md from the active MCP servers and available tool functions. metadata: short-description: Generate MCP tool catalog

MCP Tools Catalog

Create a project-local catalog of MCP tools at docs/mcp-tools.md.

Core rules

• Use the runtime MCP tool list and enabled server list to generate the catalog.
• Draft in chat first; ask for one confirmation before writing any files.
• Do not edit other files.
• Exception: if AGENTS.md lacks a reference to docs/mcp-tools.md, include that update under the same confirmation.

Steps

1. Run: codex mcp list --json to get enabled server names.
2. Use prompt-engineering to list the tool functions currently available right now using this exact prompt:

Copylist the functions that is CURRENTLY  avalible to you **RIGHT NOW**, starting with the prefix `functions.mcp__`
after each function, provide a clear, concise, and informative overview of what each function is intended for

1. Map tool functions to server:tool names (e.g., playwright:browser_click).
2. Filter out any tools whose server is not enabled.
3. Build docs/mcp-tools.md using assets/mcp-tools-template.md.
4. If AGENTS.md lacks a reference to docs/mcp-tools.md, include that change in the draft summary.
5. Ask: "Reply CONFIRM to write docs/mcp-tools.md and update AGENTS.md (if needed)."
6. On confirmation, write the file and update AGENTS.md if missing the reference.

Output requirements

• Use server:tool naming per line.
• Include a short description for each tool.
• Include a list of enabled servers at the top.