Connect Kataven MCP to Windsurf (Codeium)

Windsurf’s Cascade panel 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.

Pick whichever feels right: Cascade panel UI

Settings page

Direct file edit

OS	Path
macOS / Linux	`~/.codeium/windsurf/mcp_config.json`
Windows	`%USERPROFILE%\.codeium\windsurf\mcp_config.json`

Paste the universal entry:

{
  "mcpServers": {
    "kataven": {
      "command": "kataven-mcp",
      "env": {
        "KATAVEN_API_KEY": "sk_live_acme_..."
      }
    }
  }
}

Windsurf reloads MCP servers when you save the config. The Cascade panel’s MCP servers list shows kataven with a green dot when ready.

In a Cascade conversation:

List all my Kataven agents.

Cascade picks kataven_list_agents from its tool catalog and runs it.

What changed	Open in Hub UI
Agents	hub.kataven.ai/agents
Phone numbers	hub.kataven.ai/phone-numbers
Live or recent calls	hub.kataven.ai/conversations
Campaigns	hub.kataven.ai/campaigns