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.

Warp’s terminal AI has first-class MCP support, with a UI button and JSON paste path. 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/settingsAPI Keys tab. Full walkthrough: Install.

2. Open Warp’s MCP settings

Either:
  • SettingsAgentsMCP servers, OR
  • Command Palette (Cmd+P) → search Open MCP Servers, OR
  • Warp DrivePersonalMCP Servers
All three open the same panel.

3. Add the server

Click + Add. Warp accepts the universal JSON entry directly — paste:
{
  "mcpServers": {
    "kataven": {
      "command": "kataven-mcp",
      "env": {
        "KATAVEN_API_KEY": "sk_live_acme_..."
      }
    }
  }
}
Save. Warp launches kataven-mcp and shows it as running in the MCP servers list.
Already configured kataven-mcp for Claude Desktop or Codex? Toggle File-based MCP servers on under Settings → AI — Warp auto-detects servers from claude_desktop_config.json and ~/.codex/config.toml and reuses them, so you don’t have to add it twice.

4. Verify

Switch Warp into Agent Mode (Cmd+Shift+R, or the agent button in the prompt). Ask:
List all my Kataven agents.
The agent picks kataven_list_agents from its tool catalog.

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