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.

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.

​
2. Add the server (three equivalent paths)

Pick whichever feels right: Cascade panel UI
  1. Open the Cascade panel.
  2. Click the MCP icon in the top-right corner of Cascade.
  3. Click + Add Server.
  4. Paste the universal JSON entry below and save.
Settings page
  1. Windsurf Settings → Cascade → MCP Servers.
  2. Click View raw config to open mcp_config.json directly.
Direct file edit
OSPath
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_..."
      }
    }
  }
}

​
3. Reload (no full restart needed)

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

​
4. Verify

In a Cascade conversation:
List all my Kataven agents.
Cascade picks kataven_list_agents from its tool catalog and runs it.

​
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