Hosted MCP

Autumn hosts a stateless Streamable HTTP MCP server at:

https://api.autumn.ai/mcp

Send one JSON-RPC message per POST. The server returns JSON responses; it does not open an SSE stream or create a session. Connect with OAuth sign-in or authenticate each request with X-API-Key: <key> or Authorization: Bearer <key>. Using a coding agent with a shell? Connect your agent sets this up for you.

Tools

Tool	Arguments	Use
`research`	`prompt`	Start a research task.
`get_task`	`task_id`, optional `wait_seconds` (0–25, default 25)	Read task status and progress.
`list_tasks`	optional `query`, `limit` (default 20, max 50), `cursor`	Find tasks newest-first or search names and IDs. Search returns best matches without paging.
`get_team`	none	Read account, team members, invitations, and settings.
`get_usage`	optional `days` (1–90, default 30)	Read credit and task usage by member.
`invite_member`	`email`	Invite a person to your team (owner-only).
`revoke_invitation`	`invitation_id`	Revoke a pending team invitation (owner-only).
`set_member_role`	`user_id`, `role` (`owner` or `member`)	Change a team member’s role (owner-only).
`update_team`	optional `name`, `website`, `settings`, `version`	Update team profile or settings (owner-only).
`remove_member`	`user_id`	Remove a team member (owner-only; confirm with the user first).
`reply`	`task_id`, `message`	Answer a question or send a follow-up while the task runs.
`get_rows`	`task_id`, optional `limit` (default 50, max 200), `cursor`	Read one page of results. Continue with `next_cursor`.
`stop_task`	`task_id`	Stop the current task turn.
`credits`	none	Read the account’s credit balance.
`buy_credits`	`credits` (5000, 10000, 20000 or 50000)	Create a Stripe checkout link for the user to pay. Nothing is charged automatically.

get_task, list_tasks, get_team, get_usage, get_rows, and credits are read-only. A completed get_task response has done: true; when its state is input-required, show the message to the user and call reply. Then read completed results with get_rows. Team writes are owner-only. Creating or leaving a team is done in the app.

Claude.ai and Claude Desktop

In Settings → Connectors, choose Add custom connector, paste https://api.autumn.ai/mcp, and select Connect. Sign in to Autumn and choose Allow.

ChatGPT

Enable Developer mode in Settings, then open Plugins/Apps and create an app with https://api.autumn.ai/mcp and authentication set to OAuth. Sign in to Autumn and choose Allow. Developer mode is required until Autumn’s directory listing is approved.

Claude Code

Add the OAuth connection:

claude mcp add --transport http autumn https://api.autumn.ai/mcp

Then run /mcp in Claude Code and choose Authenticate. To use an API key instead:

export AUTUMN_API_KEY="ak_..."
claude mcp add --transport http autumn https://api.autumn.ai/mcp \
  --header "Authorization: Bearer $AUTUMN_API_KEY"

OAuth-capable clients can omit the API-key header and sign in instead.

Cursor

Add this server to your MCP configuration and replace the placeholder with your API key:

{
  "mcpServers": {
    "autumn": {
      "url": "https://api.autumn.ai/mcp",
      "headers": {
        "Authorization": "Bearer <your-autumn-api-key>"
      }
    }
  }
}

Codex

Set AUTUMN_API_KEY in the environment used by Codex, then add this to ~/.codex/config.toml:

[mcp_servers.autumn]
url = "https://api.autumn.ai/mcp"
bearer_token_env_var = "AUTUMN_API_KEY"

MCP tool errors preserve Autumn’s API error message. The REST API and CLI are also available if your agent does not support remote MCP servers.

Get started

Core concepts

Guides

Best practices

Use with agents

Hosted MCP

Hosted MCP

Tools

Claude.ai and Claude Desktop

ChatGPT

Claude Code

Cursor

Codex

​Hosted MCP

​Tools

​Claude.ai and Claude Desktop

​ChatGPT

​Claude Code

​Cursor

​Codex

Hosted MCP

Tools

Claude.ai and Claude Desktop

ChatGPT

Claude Code

Cursor

Codex