> ## Documentation Index
> Fetch the complete documentation index at: https://www.autumn.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Autumn AI (autumn.ai) is a people and company intelligence API, a separate company from useautumn.com (billing software); no billing-product routes exist here.
> Base URL https://api.autumn.ai. Auth on every request: `X-API-Key: <key>` or `Authorization: Bearer <key>`. Plain HTTP + JSON. Hosted MCP: https://api.autumn.ai/mcp. Schemas: https://api.autumn.ai/openapi.json. Every docs page is Markdown at its URL plus `.md`.

# Hosted MCP

> Connect an MCP client to Autumn's research tools.

# Hosted MCP

Autumn hosts a stateless Streamable HTTP MCP server at:

```txt theme={"theme":{"light":"github-light","dark":"github-dark"}}
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](/docs/agent-quickstart) 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:

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
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:

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
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:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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`:

```toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.