Kupe MCP

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.

Paste the remote JSON into Settings → MCP. Tools appear under kupe.

One claude mcp add command with your Bearer key.

Drop the same URL + header into ~/.codex/config.toml.

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.

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.

Install in 30 seconds

Copy from Deploy with code → Install Kupe MCP in the console to inject your live key, or paste the templates below.

Cursor
Claude Code
Codex
Stdio (local)

Add to ~/.cursor/mcp.json or project .cursor/mcp.json:

{
  "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.

claude mcp add --transport http kupe http://mcp.kupe.in/mcp \
  --header "Authorization: Bearer sk-kupe-YOUR_KEY"

Confirm with claude mcp list.

[mcp_servers.kupe]
url = "http://mcp.kupe.in/mcp"
[mcp_servers.kupe.http_headers]
Authorization = "Bearer sk-kupe-YOUR_KEY"

When you cannot reach the hosted URL:

{
  "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.

What the agent can do

Agents

Create, update, commit, archive, attach tools and analyses, run text tests.

Campaigns

Recipient lists, batches, CSV sandbox import, start / pause / resume / cancel.

Calls

Single outbound dial, inbound deployments, transcripts, recordings, analysis.

Phones

Search numbers; buy and delete require confirm=true (billed / irreversible).

Voices

List catalog + clones; clone and delete are JWT-oriented — prefer the console.

Billing & logs

Wallet, invoices, usage cost-summary / daily, sessions, tool-call events.

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

Safety

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.

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.

Quickstart

Same key works with pip install kupe and kupe-sdk.

API playground

Try REST endpoints interactively against https://x.kupe.in.

Open console

Generate a key and copy MCP install from Deploy with code.

kupe-mcp on GitHub

Source, tool list, and self-host instructions.

Get started

Realtime

Platform

MCP

Endpoint

Install in 30 seconds

What the agent can do

Agents

Campaigns

Calls

Phones

Voices

Billing & logs

Safety

Next

Quickstart

API playground

Open console

kupe-mcp on GitHub

​Endpoint

​Install in 30 seconds

​What the agent can do

Agents

Campaigns

Calls

Phones

Voices

Billing & logs

​Safety

​Next

Quickstart

API playground

Open console

kupe-mcp on GitHub

Endpoint

Install in 30 seconds

What the agent can do

Safety

Next