> ## 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 Warp Terminal

> Add Kataven to Warp's terminal AI. Warp's agent can manage voice agents and place test calls from a terminal session.

Warp's terminal AI has first-class MCP support, with a UI button and JSON paste path. `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. Open Warp's MCP settings

Either:

* **Settings** → **Agents** → **MCP servers**, OR
* Command Palette (Cmd+P) → search **`Open MCP Servers`**, OR
* **Warp Drive** → **Personal** → **MCP Servers**

All three open the same panel.

## 3. Add the server

Click **+ Add**. Warp accepts the universal JSON entry directly — paste:

```json theme={null}
{
  "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.

<Note>
  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.
</Note>

## 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 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

* [Warp's MCP docs](https://docs.warp.dev/agent-platform/capabilities/mcp/) — official, including Cloud Agents (Oz).
* [Troubleshooting](/sdks/mcp/troubleshooting).