> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kupe.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Kupe MCP

> Drive agents, campaigns, phones, and voices from Cursor, Claude Code, or Codex.

One API key. One remote URL. Your coding agent can create agents, launch campaigns, buy numbers, read transcripts, and check wallet balance — without leaving the IDE.

<div class="kupe-brand-row">
  <div class="kupe-brand-card">
    <img src="https://mintcdn.com/kupe/D6wyc45CreZUojif/images/brands/cursor.svg?fit=max&auto=format&n=D6wyc45CreZUojif&q=85&s=dee35714fa4c04ec4cd459aa324e4c6f" alt="" class="kupe-brand-logo" width="28" height="28" data-path="images/brands/cursor.svg" />

    <div>
      <strong>Cursor</strong>
      <p>Paste the remote JSON into Settings → MCP. Tools appear under <code>kupe</code>.</p>
    </div>
  </div>

  <div class="kupe-brand-card">
    <img src="https://mintcdn.com/kupe/XdUYizjTMDBp3btV/images/brands/claude.svg?fit=max&auto=format&n=XdUYizjTMDBp3btV&q=85&s=5f131cc0826722d6ac27421bc7333358" alt="" class="kupe-brand-logo" width="28" height="28" data-path="images/brands/claude.svg" />

    <div>
      <strong>Claude Code</strong>
      <p>One <code>claude mcp add</code> command with your Bearer key.</p>
    </div>
  </div>

  <div class="kupe-brand-card">
    <img src="https://mintcdn.com/kupe/D6wyc45CreZUojif/images/brands/codex.svg?fit=max&auto=format&n=D6wyc45CreZUojif&q=85&s=58361ae7489eb83419f078b3effdd01e" alt="" class="kupe-brand-logo" width="28" height="28" data-path="images/brands/codex.svg" />

    <div>
      <strong>Codex</strong>
      <p>Drop the same URL + header into <code>\~/.codex/config.toml</code>.</p>
    </div>
  </div>
</div>

## Endpoint

|               |                                               |
| ------------- | --------------------------------------------- |
| **URL**       | `http://mcp.kupe.in/mcp`                      |
| **Auth**      | `Authorization: Bearer sk-kupe-...`           |
| **Transport** | Streamable HTTP (`Accept: text/event-stream`) |

Opening that URL in a browser returns **Not Acceptable** — that is expected. It is an MCP wire protocol, not a website. Use Cursor, Claude Code, Codex, or another MCP client.

Every tool call forwards your Bearer token to `https://x.kupe.in`. Nothing is stored on the MCP host. Missing header → **401**.

<Note>
  Use **`http://mcp.kupe.in/mcp`** for the Kupe platform. The path `https://docs.kupe.in/mcp` is a separate docs-search endpoint (JSON in the browser) — not this install guide.
</Note>

## Install in 30 seconds

Copy from **Deploy with code → Install Kupe MCP** in the [console](https://hub.kupe.in) to inject your live key, or paste the templates below.

<Tabs>
  <Tab title="Cursor">
    Add to `~/.cursor/mcp.json` or project `.cursor/mcp.json`:

    ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
    {
      "mcpServers": {
        "kupe": {
          "url": "http://mcp.kupe.in/mcp",
          "headers": {
            "Authorization": "Bearer sk-kupe-YOUR_KEY"
          }
        }
      }
    }
    ```

    Then open **Cursor Settings → MCP**, confirm `kupe` is connected, and restart if needed.
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    claude mcp add --transport http kupe http://mcp.kupe.in/mcp \
      --header "Authorization: Bearer sk-kupe-YOUR_KEY"
    ```

    Confirm with `claude mcp list`.
  </Tab>

  <Tab title="Codex">
    ```toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
    [mcp_servers.kupe]
    url = "http://mcp.kupe.in/mcp"
    [mcp_servers.kupe.http_headers]
    Authorization = "Bearer sk-kupe-YOUR_KEY"
    ```
  </Tab>

  <Tab title="Stdio (local)">
    When you cannot reach the hosted URL:

    ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
    {
      "mcpServers": {
        "kupe": {
          "command": "uvx",
          "args": ["kupe-mcp"],
          "env": {
            "KUPE_API_KEY": "sk-kupe-YOUR_KEY"
          }
        }
      }
    }
    ```

    Or from a clone: `python -m app.server --mcp` with `KUPE_API_KEY` set.
  </Tab>
</Tabs>

## What the agent can do

<CardGroup cols={2}>
  <Card title="Agents" icon="bot">
    Create, update, commit, archive, attach tools and analyses, run text tests.
  </Card>

  <Card title="Campaigns" icon="megaphone">
    Recipient lists, batches, CSV sandbox import, start / pause / resume / cancel.
  </Card>

  <Card title="Calls" icon="phone">
    Single outbound dial, inbound deployments, transcripts, recordings, analysis.
  </Card>

  <Card title="Phones" icon="smartphone">
    Search numbers; **buy** and **delete** require `confirm=true` (billed / irreversible).
  </Card>

  <Card title="Voices" icon="audio-lines">
    List catalog + clones; clone and delete are JWT-oriented — prefer the console.
  </Card>

  <Card title="Billing & logs" icon="wallet">
    Wallet, invoices, usage cost-summary / daily, sessions, tool-call events.
  </Card>
</CardGroup>

Also: knowledge bases, call databases, org tools, and Composio connections.

## Safety

<AccordionGroup>
  <Accordion title="Never commit the API key">
    Treat `sk-kupe-...` like a password. Clipboard copy in the console warns you.
    Prefer project-scoped keys you can revoke.
  </Accordion>

  <Accordion title="Confirm-gated tools">
    Phone **buy**, phone **delete**, and cloned-voice **delete** require
    `confirm=true`. The model must not invent that flag — your agent should
    ask you first.
  </Accordion>
</AccordionGroup>

## Next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Same key works with `pip install kupe` and `kupe-sdk`.
  </Card>

  <Card title="API playground" icon="terminal" href="/playground">
    Try REST endpoints interactively against `https://x.kupe.in`.
  </Card>

  <Card title="Open console" icon="layout-dashboard" href="https://hub.kupe.in">
    Generate a key and copy MCP install from Deploy with code.
  </Card>

  <Card title="kupe-mcp on GitHub" icon="github" href="https://github.com/kupe-ai/kupe-mcp">
    Source, tool list, and self-host instructions.
  </Card>
</CardGroup>