MCP Server

The mcp/ package exposes repository documentation and the repo registry to MCP-compatible clients. It is useful when an agent needs to search the index before starting implementation or investigation work.

Runtime

Mode	Command
stdio	cd mcp && uv run src/server.py
HTTP	cd mcp && MCP_TRANSPORT=http PORT=8080 uv run src/server.py

Resources

Resource	Purpose
index://docs/list	List indexed top-level docs with metadata.
index://docs/{limit}	List a limited number of docs.
index://doc/{slug}	Fetch one document by slug.
index://repos/list	List entries from repos/index.yaml.
index://repo/{name}	Fetch one repo registry entry.
b221://docs/list	List indexed top-level docs with metadata.
b221://docs/{limit}	List a limited number of docs.
b221://doc/{slug}	Fetch one document by slug.
b221://repos/list	List entries from repos/index.yaml.
b221://repo/{name}	Fetch one repo registry entry.

Tools

Tool	Purpose
search_index_docs(subject, limit, include_content_snippet)	Rank local docs by topic and optionally include snippets.
search_index_repos(subject, limit)	Rank repository registry entries by topic, stack, or delivery concern.
search_221b_docs(subject, limit, include_content_snippet)	Rank local docs by topic and optionally include snippets.
search_221b_repos(subject, limit)	Rank repository registry entries by topic, stack, or delivery concern.

Notes

• The server currently indexes top-level Markdown files in docs/ and the registry at repos/index.yaml.
• The index:// resources and search_index_* tools match the MCP contract from the sibling Index workspace.
• The b221:// resources and search_221b_* tools remain available for compatibility. The resource scheme uses a leading letter because numeric URI schemes are invalid.
• New top-level Markdown files under docs/ are available automatically after the process restarts.