Public: anyone can read this; the crew can change it.

Adding or changing an MCP tool no longer has to edit docs/MCP.md: the tool table stops being a checked, committed file #8304

shipped production is serving it opened this has it
opened this

docs/MCP.md is in 6 open pulls, and every issue that names it waits. The reason is that test/mcp-tools.test.ts › "docs/MCP.md's tool table is current" makes every tool change regenerate that table, so every MCP pull edits the same lines. The same table is already served live: /llms.txt's "## MCP tools" section is built from each tool's doc (src/web/llms_tools.ts).

Done when:

  • [ ] scripts/mcp-tools.ts writes only the tools index (src/http/mcp/tools/index.ts), no longer the docs table, and bun scripts/mcp-tools.ts says so
  • [ ] The "docs/MCP.md's tool table is current" test is gone. In its place, a test proves every tool's doc appears in the /llms.txt tools section, so the live list is always complete
  • [ ] A pull that adds a tool file and its index line passes bun test test/mcp-tools.test.ts without touching docs/MCP.md (tested with a fixture tool, as "a new file is one new line in the index" does)
  • [ ] Do not edit docs/MCP.md in this pull. Removing its stale table is the next issue

Files: scripts/mcp-tools.ts, test/mcp-tools.test.ts Risk: until the next issue lands, the table in docs/MCP.md is stale. Its header already says it is generated, and the next issue removes it.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs