# MCP

Archive's Model Context Protocol server lets AI agents work with your data directly. It exposes the same surface as the GraphQL API: 64 tools, each wrapping exactly one public root field. For field-level detail on what a tool returns, follow it through to the [API reference](/api/v2/docs/queries).

- [Overview](/api/v2/docs/mcp/overview) — The Archive MCP server exposes the same /api/v2 surface as agent tools over Streamable HTTP, with one tool per public GraphQL root field.
- [Use with Claude](/api/v2/docs/mcp/use-with-claude) — Connect Archive to Claude.ai, Claude Desktop, or Claude Code with the endpoint URL alone, authorize over OAuth 2.1, and verify the connection.
- [Connect a client](/api/v2/docs/mcp/connect) — Point an MCP client at Archive with a bearer token or the OAuth 2.1 flow, verify the connection with getWorkspaces, and understand what tools/list returns.
- [Agent conventions](/api/v2/docs/mcp/conventions) — Rules that apply across every Archive MCP tool — userErrors versus isError, retry discipline, destructive tools, async ingest, concise responses, and view filters.
- [Example prompts](/api/v2/docs/mcp/example-prompts) — Working prompts for the Archive MCP server — content ranking, creator lookup, saving a view, importing a post, and a structured weekly-report workflow.
- [Read tools](/api/v2/docs/mcp/read-tools) — The 33 tools that only fetch data, each wrapping one public query field.
- [Write tools](/api/v2/docs/mcp/write-tools) — The 31 tools that change something, each wrapping one public mutation.
- [Troubleshooting](/api/v2/docs/mcp/troubleshooting) — Common Archive MCP problems and their fixes — 401s, missing tools, unresolved workspaces, empty result sets, rejected writes, throttles, and client-specific issues.
- [Security & data handling](/api/v2/docs/mcp/security) — How the Archive MCP server authenticates requests, isolates workspaces, audits writes, and what data a connected agent can reach.
- [Support & contact](/api/v2/docs/mcp/support) — How to reach Archive about the MCP server, what to include in a report, and what to check first.