Skip to main content

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.

Cursor speaks MCP over local stdio — kataven-mcp plugs in directly.
Already done Install? Skip to step 2.

​
1. Mint an API key + install the binary

pip install kataven-mcp, then mint a key at hub.kataven.ai/settings → API Keys tab. Full walkthrough: Install.

​
2. Edit Cursor’s MCP config

Pick the scope you want:
ScopePath
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: 
{
  "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.
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.

​
5. Verify in the dashboard

What changedOpen in Hub UI
Agentshub.kataven.ai/agents
Phone numbershub.kataven.ai/phone-numbers
Live or recent callshub.kataven.ai/conversations
Campaignshub.kataven.ai/campaigns

​
See also