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.

VS Code’s MCP support is built into GitHub Copilot agent mode. Two things to note up front:
  • VS Code uses mcp.json as the filename (not claude_desktop_config.json or similar).
  • The top-level key is servers (not mcpServers!) — pasting the universal entry verbatim won’t work here.
  • MCP tools work in Agent mode only. Ask and Edit modes ignore them.
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. Open the VS Code MCP config

Cmd+Shift+P (Ctrl+Shift+P on Windows/Linux) → MCP: Open User Configuration. This opens (or creates) mcp.json in your VS Code user-config directory.

​
3. Paste the VS Code-specific shape

{
  "servers": {
    "kataven": {
      "command": "kataven-mcp",
      "env": {
        "KATAVEN_API_KEY": "sk_live_acme_..."
      }
    }
  }
}
Note: servers, not mcpServers. Save.

​
4. Switch Copilot to Agent mode

Open Copilot Chat (Cmd+Shift+I or the chat icon in the sidebar). At the top of the chat panel, switch the mode picker to Agent. The kataven_* tools are now callable.
List all my Kataven agents.
VS Code’s MCP is stdio-only. Servers requiring SSE or Streamable HTTP transport won’t work here today (kataven-mcp is stdio, so no issue). MCP tools also don’t surface in Ask or Edit modes — only Agent mode invokes them.

​
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