Halo MCP server
How it works, connecting clients, the protocol, your own OAuth client and agents.
- How the MCP server works What Halo's MCP server is, its endpoint, tools and scopes, how it runs, its limits, and when to use it rather than the REST API.
- Connect a client Connect Claude Code, Claude, Cursor, VS Code, the MCP Inspector or anything else to Halo's MCP server, with OAuth or a personal token.
- The MCP protocol Raw JSON-RPC against Halo's MCP server with cURL. Required headers, tools/list, tools/call, the 401 challenge, the halo-data fence, limits, and how errors come back.
- Build an OAuth client Sign people in to Halo's MCP server from your own client. Metadata discovery, registration, PKCE, consent, code exchange, token lifetimes, rotation and scopes, in TypeScript.
- Build an agent An agent in TypeScript that answers questions from Halo, using the MCP SDK and the Anthropic SDK in a manual tool loop, and treats what it reads as data.