Skip to main content

Documentation Index

Fetch the complete documentation index at: https://katavenai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

You can manage Kataven entirely through Claude. Two flavors depending on where you’re using Claude.

​
Option A — Claude Code (or any agent with a shell)

Claude Code can write Python and execute it. Install the SDK once, configure the env vars, and ask Claude to do the rest. 
pip install kataven
export KATAVEN_API_KEY="..."
export KATAVEN_ACCOUNT_ID="acme"
Then in Claude Code, just ask:
“List all my agents and tell me which ones are active. Then create a new agent called ‘Sales SDR’ that knows about our pricing tiers.”
Claude will read the SDK docs, write the Python, and run it. No MCP required — the SDK is the headless surface.

​
Option B — Claude Desktop / Cursor / any chat-only agent

Chat-only Claude has no shell. To drive Kataven from there, install the MCP server, which exposes every SDK verb as a Claude-callable tool.

​
Install

pip install kataven-mcp

​
Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json: 
{
  "mcpServers": {
    "kataven": {
      "command": "kataven-mcp",
      "env": {
        "KATAVEN_API_KEY": "eyJhbGciOi...",
        "KATAVEN_ACCOUNT_ID": "acme"
      }
    }
  }
}
Restart Claude Desktop. The Kataven tools (kataven_list_agents, kataven_create_agent, kataven_originate_call, etc.) appear in the tool list.

​
Then ask away

“Show me all phone numbers I’ve registered, and tell me which ones aren’t pinned to an agent.”
“Create an agent called ‘Front Desk’ with a friendly greeting, then attach the ‘general-faqs’ playbook to it.”
“Place a test call from +12025550123 to my cell +14155550100 using the Front Desk agent.”

​
Which to choose?

You’re working in…Use
Claude CodeSDK (no MCP needed — Claude has a shell)
Cursor with composer / agent modeSDK
Claude Desktop, ChatGPT Desktop, mobile chatMCP
n8n / Zapier-style workflow with an LLM stepMCP
Custom agent (LangGraph, Agno, etc.)Either; MCP is easier to plug in
The MCP server is a thin wrapper around the SDK — same functionality, different protocol. You don’t need both; pick the one that matches your runtime.