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

# Connect Kataven MCP to Cursor

> Set up the Kataven MCP server in Cursor IDE. Manage Kataven voice agents, place test calls, and run campaigns from inside Cursor's composer or chat.

Cursor speaks MCP over local stdio — `kataven-mcp` plugs in directly.

<Note>
  Already done [Install](/sdks/mcp/install)? Skip to step 2.
</Note>

## 1. Mint an API key + install the binary

`pip install kataven-mcp`, then mint a key at [hub.kataven.ai/settings](https://hub.kataven.ai/settings) → **API Keys** tab. Full walkthrough: [Install](/sdks/mcp/install).

## 2. Edit Cursor's MCP config

Pick the scope you want:

| Scope                            | Path                                                                                         |
| -------------------------------- | -------------------------------------------------------------------------------------------- |
| **Global** (all your projects)   | `~/.cursor/mcp.json` (macOS / Linux) · `%USERPROFILE%\.cursor\mcp.json` (Windows)            |
| **Per-project** (this repo only) | `.cursor/mcp.json` in the repo root — useful when you want different MCP servers per project |

Create the file if it doesn't exist. Paste:

```json theme={null}
{
  "mcpServers": {
    "kataven": {
      "command": "kataven-mcp",
      "env": {
        "KATAVEN_API_KEY": "sk_live_acme_..."
      }
    }
  }
}
```

## 3. Restart Cursor

Cmd+Q (Mac) / Ctrl+Q (Linux) / right-click system tray → Exit (Windows) → relaunch.

## 4. Verify

In Cursor → **Settings → Cursor Settings → MCP**. The `kataven` entry appears in the list with a green dot if it loaded successfully. Open Cursor's chat or composer, switch to **Agent** mode, and ask:

> List all my Kataven agents.

The agent calls `kataven_list_agents`. If it asks before running (default), approve.

<Note>
  **Cursor caps active MCP tools at \~40 across all configured servers.** If you have many MCP servers configured, the agent silently loses access to some tools above that threshold. Disable MCP servers you don't need from the same Settings → MCP panel, or scope kataven to a per-project `.cursor/mcp.json` if it's only relevant for one repo.
</Note>

## 5. Verify in the dashboard

| What changed         | Open in Hub UI                                                       |
| -------------------- | -------------------------------------------------------------------- |
| Agents               | [hub.kataven.ai/agents](https://hub.kataven.ai/agents)               |
| Phone numbers        | [hub.kataven.ai/phone-numbers](https://hub.kataven.ai/phone-numbers) |
| Live or recent calls | [hub.kataven.ai/conversations](https://hub.kataven.ai/conversations) |
| Campaigns            | [hub.kataven.ai/campaigns](https://hub.kataven.ai/campaigns)         |

## See also

* [Manage with Claude Desktop](/guides/manage-with-claude-desktop) — same MCP idea, more example prompts (Cursor uses Claude under the hood by default).
* [Troubleshooting](/sdks/mcp/troubleshooting) — Cursor-specific tool-cap warnings + general diagnostics.