MCP
Connect an MCP client to Andy's authenticated tenant operations — agent-first install, auth, tools, and troubleshooting.
Outcome
Connect an MCP client to Andy's 29 job-oriented tools, backed by the same server-side authorization, schemas and stable problems as HTTP and CLI. Agents install once, list tools, and call get_context to orient and prove the session.
Agent-first pitch
Andy MCP is the authenticated product surface for agents and automation:
- Endpoint:
https://app.andypartner.com/api/mcp - Auth: Browser OAuth (recommended), or a Workspace API Key for headless/CI use
- Tools: 29 job-oriented tools — see Tool catalog
- Verify: list tools (exactly 29) and call
get_context→data.selection.status+meta.requestId(prefixmcp-)
get_context is globally available and is the only orientation call you need. ask_agent needs the public_chat:write scope and an agent with mcpAllowed. No tool ever asks a human for a Workspace or Agent id.
Prerequisites
- A supported MCP client (Claude Code, Codex, Cursor, or any Streamable HTTP client).
- An Andy account for browser OAuth, or a Workspace API Key from App → workspace → API Integration for headless/CI use.
- For OAuth users with multiple Workspaces, call
get_contextand replay one of theselect_workspacecalls it returns.
Install guides
| Client | Guide | Notes |
|---|---|---|
| Claude Code | Claude Code | Recommended — paste the URL and complete browser OAuth |
| Codex CLI | Codex | Bearer token via env var name |
| Cursor | Cursor | Config reference only until live-verified |
| Generic | Generic JSON | URL + headers map + raw JSON-RPC probe |
Auth, scopes, and blast radius
See Auth and scopes for key blast radius, Pro Max gate, MCP entitlement, and least-privilege guidance.
Tool catalog
Every advertised tool is listed in Tool catalog with its full input schema and annotations. The granular Tenant Operations each tool composes — including the many that are CLI/HTTP-only — are in the CLI Reference.
Troubleshooting
See MCP troubleshooting for HTTP/JSON-RPC failure table (-32001, -32002, 401, scope, Pro Max).
Canonical snippets
Install commands and config blocks are published from the monorepo source of truth:
docs/mcp-install-snippets.md
Do not invent alternate endpoints or auth schemes.
Next step
Pick a client guide above, then call get_context. This documentation site does not expose an Ask AI route or a separate documentation MCP server.