> ## Documentation Index > Fetch the complete documentation index at: https://docs.atako.ai/llms.txt > Use this file to discover all available pages before exploring further. # Atako MCP > Connect Claude Code, Claude Desktop, Cursor, or ChatGPT to your Atako account over the Model Context Protocol. Atako runs a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server at `https://api.atako.ai/mcp`, so an AI client you already use — Claude Code, Claude Desktop, Cursor, ChatGPT developer mode, or any other MCP client — can read **and act on** your Atako account directly: your agents, their chat history and files, integration connections, activity, credits, and subscription. Most tools read existing state. Some now write too: create, rename, end, and resume agents; send a message and wait for the reply; upload a file to an agent; connect an integration and grant it to an agent. Two things still need you in a browser — an OAuth integration connection needs your consent on the provider's own page, and any billing/subscription change happens on [app.atako.ai](https://app.atako.ai) — no tool can do either for you. Jump to the [quickstart](/developers/mcp/quickstart) for copy-pasteable client configs. ## Connecting You need a programmatic [API key](/developers/api-keys) (`aik_…`) from **Settings → API keys**. Point your MCP client at the URL below with that key as a Bearer token: ``` URL: https://api.atako.ai/mcp Header: Authorization: Bearer aik_... ``` Transport is Streamable HTTP (the current MCP spec's recommended transport) — no separate install for most clients, since they speak it natively. A key acts as its owning user: an MCP client connected with your key can do exactly what you'd be able to do logged into the app — read and manage your own agents, plus any agent your teammates created that you have access to through a shared team or company-wide visibility. ## Try it Some things you can ask, once connected: * *"List my Atako agents and tell me which ones are idle."* * *"Create an agent that triages my Zendesk tickets and drafts replies."* * *"Send my support agent a message asking for today's ticket count, and wait for its reply."* * *"Connect my GitHub token and grant it to my engineering agent, read-only."* * *"What's my credit balance and how many agent seats do I have left?"* ## Tools ### Read | Tool | What it returns | | ------------------------------- | ------------------------------------------------------------------------------ | | `list_agents` | Every agent you can see, with status and a preview of the last message | | `get_agent` | Full detail for one agent | | `whoami` | Your identity, company, and subscription plan | | `list_messages` | Your chat history with one agent | | `wait_for_reply` | Blocks (up to 25s) for an agent's next reply — call right after `send_message` | | `list_cron_jobs` | An agent's recurring scheduled tasks and their run history | | `list_sub_agents` | Sub-agents an agent has spawned to delegate work | | `list_interagent_messages` | Messages an agent exchanged with company peers | | `list_activity` | An agent's live activity timeline (turns, tool calls, sub-agents) | | `get_activity_state` | Whether an agent is currently working | | `list_agent_files` | Files an agent can currently reach | | `list_integration_catalog` | Every third-party integration Atako supports | | `list_integration_connections` | Your own connected integrations | | `list_agent_integration_grants` | Which connections an agent may use, and how | | `get_connect_url` | Starts an OAuth connection, returns the URL to open in a browser | | `get_credits` | Your company's credit balance and consumption this period | | `get_subscription` | Your company's plan, status, and agent slot usage | | `list_models` | AI models available when creating/configuring an agent | | `list_harnesses` | Execution harnesses available when creating an agent | ### Write | Tool | What it does | | ------------------------------- | ------------------------------------------------------------------------------- | | `create_agent` | Creates a new agent — only `name` is required | | `update_agent_name` | Renames an agent | | `end_agent` | Ends an active agent, freeing its seat | | `resume_agent` | Resumes a paused agent | | `cancel_agent_provisioning` | Cancels an agent still provisioning | | `retry_agent_provisioning` | Retries a failed provisioning | | `send_message` | Sends a chat message to an agent (fire-and-forget — pair with `wait_for_reply`) | | `upload_file_to_agent` | Uploads a file (≤10 MiB, base64) and grants it to an agent, in one call | | `create_integration_connection` | Connects an integration by pasting an API key/token | | `grant_integration_to_agent` | Grants an agent access to a connection, and which actions | | `revoke_integration_grant` | Revokes an agent's access to an integration | A public, unauthenticated endpoint at `https://api.atako.ai/mcp/public` also exposes 3 marketing tools with no API key required — `get_pricing`, `list_use_cases`, and `list_integration_pages` — useful for an assistant researching Atako itself rather than acting on your account. ### Scheduling and delegation are agent-authored There's no `create_cron_job` or `create_sub_agent` tool, on purpose: an agent schedules its own recurring tasks and spawns its own sub-agents while it works, in response to being asked in a normal conversation — not through a separate creation API. Tell the agent what you want ("every Monday at 9am, check X and send me a summary") and then use `list_cron_jobs` to confirm what it set up and inspect its run history. ### Two things still need a browser * **OAuth integrations** — `get_connect_url` gets you the authorization URL, but finishing an OAuth consent screen needs you in an actual browser. For a provider that just needs a pasted API key/token instead, `create_integration_connection` works with no browser step at all. * **Billing and subscription changes** — there's no MCP tool for this at all. Go to **app.atako.ai → Settings → Billing**. ## Resources & prompts * **Resources**: `atako://agents/{id}` (same shape as `get_agent`), `atako://agents/{id}/files` (same shape as `list_agent_files`), and `atako://docs/quickstart` (this product's own quickstart guide, for a client that wants to ground itself in what Atako is before calling any tool). * **Prompts**: `diagnose_agent_issue` (pulls an agent's state, activity, and recent messages together to help figure out why it seems stuck), `weekly_credits_report` (a quick credits/subscription/agent-roster summary), `create_support_agent_from_brief` (turns a free-form description into a structured `create_agent` call), and `connect_integration_wizard` (walks through connecting one provider end-to-end, picking the right tool for how it authenticates). ## What's next OAuth 2.1 with Dynamic Client Registration — a one-click "connect" experience from claude.ai/ChatGPT connectors instead of pasting an API key — is planned for a future release, along with a granular scope model narrower than "this key can do everything its owner can".