atproto-docs-mcp #
An MCP server that gives agents search over atproto.com (AT Protocol specs, guides, blog) and returns markdown snippets with section-anchored citation urls.
packages/docs_mcp_server: the FastMCP server (search_atproto_docs,get_atproto_doc,list_atproto_docs)packages/ingestion_pipeline: Prefect flow that indexes atproto.com from its source repo into Turbopuffer
Content comes from bluesky-social/atproto-website (the source of atproto.com, CC-BY), parsed with the site's own remark plugins so anchors match the live pages.
uv sync
export TURBOPUFFER_API_KEY=...
uv run -m atproto_docs_ingest.main prod # build the index
uv run atproto-docs-mcp # serve over stdio
uv run pytest
FastMCP Cloud entrypoint: packages/docs_mcp_server/atproto_docs_mcp/_server.py:app
Hosted at https://atproto-docs-mcp.fastmcp.app/mcp (Prefect Horizon). scripts/horizon_deploy.py builds the pushed origin/main commit from tangled and deploys it; --sync-secrets also copies TURBOPUFFER_API_KEY and LOGFIRE_TOKEN from the sops store into the project. Every tool call is a tool call {tool} span with client_ip, user_agent and an outcome (ok, limited_client, limited_global, error), sent to the shared atproto Logfire project (pub-search) as service atproto-docs-mcp.
HORIZON_API_KEY=... uv run --no-project python scripts/horizon_deploy.py