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

# Kataven docs — voice & chat AI agents you can deploy in minutes

> Build AI voice agents that answer phone calls, run outbound campaigns, and live in your website widget. Manage every endpoint from Python, Node, the REST API, or AI tools like Claude, ChatGPT, and Codex.

Kataven is the platform behind production AI voice agents. Sign up, point a phone number at an agent, and you have a 24/7 receptionist that books appointments, answers FAQs, and runs outbound campaigns — speaking real-time over PSTN, WebRTC, and embeddable web widgets.

The **Hub API** is how you drive it programmatically: every screen in the dashboard at [hub.kataven.ai](https://hub.kataven.ai) is a thin client over the same REST endpoints your scripts, CI pipelines, and AI tools (Claude, ChatGPT, Codex) call.

## What you can build

<CardGroup cols={2}>
  <Card title="AI phone agents" icon="phone" href="/concepts/agents">
    Inbound + outbound voice over Twilio, Plivo, or Vobiz. Sub-800ms latency end-to-end.
  </Card>

  <Card title="Bulk outbound campaigns" icon="megaphone" href="/concepts/campaigns">
    Upload a CSV, dial thousands of contacts with cap-aware concurrency, watch live metrics over SSE.
  </Card>

  <Card title="Embeddable widget" icon="window" href="/concepts/widget">
    Drop a launcher into any website. Anonymous or authenticated visitors. Per-domain allowlists.
  </Card>

  <Card title="Tools, knowledge, integrations" icon="wrench" href="/concepts/tools">
    Built-in + custom tools. Stripe, Shopify, Slack integrations. Encrypted credentials.
  </Card>

  <Card title="Drive everything from AI" icon="sparkles" href="/guides/ai-agents">
    Connect Claude Code, Claude Desktop, ChatGPT, Codex, or any MCP-aware client. They call the API for you.
  </Card>

  <Card title="Multi-tenant by default" icon="building" href="/concepts/multi-tenancy">
    Per-account Postgres isolation, per-tenant rate caps, no shared state.
  </Card>
</CardGroup>

## Pick your interface

| You're…                                        | Use                                           | Reference                                                        |
| ---------------------------------------------- | --------------------------------------------- | ---------------------------------------------------------------- |
| Calling the API directly from any language     | REST                                          | [API Reference](/api-reference/introduction)                     |
| Writing Python (server scripts, data jobs, CI) | Python SDK (`pip install kataven`)            | [Python SDK](/sdks/python/overview)                              |
| Writing Node / TypeScript on the server        | Node SDK (`npm install @kataven/server`)      | [Node SDK](/sdks/node/overview)                                  |
| Driving Kataven from **Claude Code**           | The Python SDK — Claude has a shell           | [Manage with Claude Code](/guides/manage-with-claude-code)       |
| Driving Kataven from **Claude Desktop**        | The MCP server                                | [Manage with Claude Desktop](/guides/manage-with-claude-desktop) |
| Driving Kataven from **ChatGPT**               | The MCP server (Desktop) or OpenAI Agents SDK | [Manage with ChatGPT](/guides/manage-with-chatgpt)               |
| Driving Kataven from **Codex CLI**             | The Python SDK — Codex has a shell            | [Manage with Codex](/guides/manage-with-codex)                   |
| Embedding voice / chat in your website         | Browser SDK (`@kataven/client`)               | [Embed widget guide](/guides/embed-widget)                       |

## Start in 60 seconds

<Steps>
  <Step title="Get an API key">
    Open [hub.kataven.ai/settings](https://hub.kataven.ai/settings), click the **API Keys** tab, then **Create API key**. Pick an expiry (Never / 1y / 90d / 30d), click **Create**, and copy the `sk_live_…` value — it's shown **once**.

    <Note>The plaintext key is only displayed at creation time. We store an HMAC, not the token. Lose it and you mint a new one.</Note>
  </Step>

  <Step title="Make your first API call">
    Set the env var, then list your agents in five lines of code. Full walkthrough at the [Quickstart](/quickstart).

    ```bash theme={null}
    export KATAVEN_API_KEY="sk_live_acme_…"
    pip install kataven
    python -c "from kataven import KatavenClient; print(KatavenClient().agents.list())"
    ```
  </Step>

  <Step title="Build your first voice agent">
    Walk through [Your first agent](/guides/your-first-agent) — create the agent, attach a phone number, and place a test call. \~10 minutes from blank account to ringing your cell.
  </Step>

  <Step title="Hand it off to AI">
    Once your agent works, let an AI tool drive it for you: [Claude Code](/guides/manage-with-claude-code) (or [Claude Desktop](/guides/manage-with-claude-desktop), [ChatGPT](/guides/manage-with-chatgpt), [Codex](/guides/manage-with-codex)) can manage agents, run campaigns, and place test calls without you writing code.
  </Step>
</Steps>

## What's in the docs

* **[Concepts](/concepts/agents)** — what every primitive (agents, tools, playbooks, FAQs, campaigns, widget, telephony, multi-tenancy, rate limits) actually does.
* **[Guides](/guides/your-first-agent)** — opinionated walkthroughs for common end-to-end flows.
* **[API Reference](/api-reference/introduction)** — every endpoint, every field, with try-it.
* **[Python SDK](/sdks/python/overview)** + **[Node SDK](/sdks/node/overview)** + **[MCP Server](/sdks/mcp/overview)** — language- and tool-specific references.

## Help

* Found a docs bug, hit a confusing error, or want an API change? Reach out at [support@kataven.ai](mailto:support@kataven.ai). Include the doc URL or the API endpoint you were on — we'll route it.