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

# MCP API overview

> Connect your AI tools to InboxMate via the Model Context Protocol (MCP).

The InboxMate MCP API lets Business plan customers connect AI tools like **Claude Code**, **Cursor**, or custom AI agents to their InboxMate workspace.

## Protocol

The API uses the **Model Context Protocol (MCP)** with JSON-RPC 2.0 over HTTP. This means you can add InboxMate as an MCP server in any MCP-compatible client.

## Base URL

```
https://app.psquared.dev/api/mcp/v1
```

## Available tools

| Category                                      | Tools                                    | Access |
| --------------------------------------------- | ---------------------------------------- | ------ |
| [Agents](/api-reference/agents)               | `list_agents`, `get_agent`               | Read   |
| [Conversations](/api-reference/conversations) | `list_conversations`, `get_conversation` | Read   |
| [Contacts](/api-reference/contacts)           | `list_contacts`, `get_contact`           | Read   |
| [Knowledge](/api-reference/knowledge)         | `list_knowledge`, `get_knowledge`        | Read   |
| [Review pages](/api-reference/demo-pages)     | `create_demo_page`                       | Write  |

## Quick setup

<Steps>
  <Step title="Get your API key">
    Go to **Settings > API** in your InboxMate dashboard and generate an API key.
  </Step>

  <Step title="Add to your MCP client">
    Add InboxMate as an MCP server in your client's configuration.

    **Claude Code** (`~/.claude.json`):

    ```json theme={null}
    {
      "mcpServers": {
        "inboxmate": {
          "type": "streamable-http",
          "url": "https://app.psquared.dev/api/mcp/v1",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    **Cursor** (`.cursor/mcp.json`):

    ```json theme={null}
    {
      "mcpServers": {
        "inboxmate": {
          "type": "streamable-http",
          "url": "https://app.psquared.dev/api/mcp/v1",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Start using it">
    Ask your AI assistant to list your agents, review conversations, or search your knowledge base.
  </Step>
</Steps>

## Rate limits

| Plan     | Requests per minute |
| -------- | ------------------- |
| Business | 60                  |

## Requirements

* **Business plan** or higher
* An active API key generated from your dashboard

<Info>
  Need help setting up? Contact us at [office@psquared.dev](mailto:office@psquared.dev).
</Info>