# Kupe > Voice agents API — Python SDK, TypeScript SDK, and MCP. ## Docs - [Kupe](https://docs.kupe.in/index.md): Voice agents over HTTP and WebSocket — Python, TypeScript, cURL, and MCP. - [Quickstart](https://docs.kupe.in/quickstart.md): Install the Kupe SDK and run a realtime text turn in under a minute. - [Authentication](https://docs.kupe.in/auth.md): Bearer API keys, JWTs, and GET /v1/me for org and project IDs. - [API playground](https://docs.kupe.in/playground.md): Interactive OpenAPI Try it against https://x.kupe.in with Bearer auth. - [Realtime WebSocket](https://docs.kupe.in/realtime.md): Mint a session, connect to wss://x.kupe.in/v1/realtime, and handle OpenAI-compatible events. - [Campaigns](https://docs.kupe.in/guides/campaigns.md): Outbound batches, contacts, recipient lists, and live status. - [Inbound](https://docs.kupe.in/guides/inbound.md): Bind an agent to a phone number and set when it answers. - [Phones](https://docs.kupe.in/guides/phones.md): Search, buy, and release numbers. India KYC when required. - [Voices](https://docs.kupe.in/guides/voices.md): Catalog voices, clones, preview audio, and billed speak. - [Tools and Composio](https://docs.kupe.in/guides/tools.md): Webhook, MCP, and Composio tools — catalog, connect, attach to agents. - [Databases](https://docs.kupe.in/guides/databases.md): Call databases, rows, export, and knowledge bases for RAG. - [Logs](https://docs.kupe.in/guides/logs.md): Sessions, transcripts, recordings, and tool-call events. - [Billing and usage](https://docs.kupe.in/guides/billing.md): Wallet, invoices, cost summary, and daily usage — no checkout. - [Kupe MCP](https://docs.kupe.in/kupe-mcp.md): Drive agents, campaigns, phones, and voices from Cursor, Claude Code, or Codex. - [Current principal](https://docs.kupe.in/api-reference/me/current-principal.md): Auth type plus, for API keys, the org and project scoped to the key. - [List Orgs](https://docs.kupe.in/api-reference/orgs/list-orgs.md) - [Create Org](https://docs.kupe.in/api-reference/orgs/create-org.md) - [Get Org](https://docs.kupe.in/api-reference/orgs/get-org.md) - [Update Org](https://docs.kupe.in/api-reference/orgs/update-org.md) - [Get Org Balance](https://docs.kupe.in/api-reference/billing/get-org-balance.md) - [Adjust Org Balance](https://docs.kupe.in/api-reference/billing/adjust-org-balance.md): Top up (positive) or deduct (negative) an org's calling balance. Admin-only — this is a blunt manual ledger, not a payments flow. - [Get Wallet](https://docs.kupe.in/api-reference/billing/get-wallet.md) - [List Invoices](https://docs.kupe.in/api-reference/billing/list-invoices.md) - [Invoice Pdf](https://docs.kupe.in/api-reference/billing/invoice-pdf.md): Generate the PDF in memory and stream it. Nothing is stored. - [List Members](https://docs.kupe.in/api-reference/members/list-members.md) - [Add Member](https://docs.kupe.in/api-reference/members/add-member.md) - [My Membership](https://docs.kupe.in/api-reference/members/my-membership.md) - [Remove Member](https://docs.kupe.in/api-reference/members/remove-member.md) - [Update Member Role](https://docs.kupe.in/api-reference/members/update-member-role.md) - [Bootstrap Flags](https://docs.kupe.in/api-reference/feature-flags/bootstrap-flags.md) - [Get Org Access](https://docs.kupe.in/api-reference/feature-flags/get-org-access.md) - [Patch Org Access](https://docs.kupe.in/api-reference/feature-flags/patch-org-access.md) - [Patch Member Access](https://docs.kupe.in/api-reference/feature-flags/patch-member-access.md) - [List Projects](https://docs.kupe.in/api-reference/projects/list-projects.md) - [Create Project](https://docs.kupe.in/api-reference/projects/create-project.md) - [Archive Project](https://docs.kupe.in/api-reference/projects/archive-project.md) - [List Agents](https://docs.kupe.in/api-reference/agents/list-agents.md) - [Create Agent](https://docs.kupe.in/api-reference/agents/create-agent.md) - [Get Agent](https://docs.kupe.in/api-reference/agents/get-agent.md) - [Patch Agent](https://docs.kupe.in/api-reference/agents/patch-agent.md) - [Commit Agent](https://docs.kupe.in/api-reference/agents/commit-agent.md) - [Archive Agent](https://docs.kupe.in/api-reference/agents/archive-agent.md) - [Demo Variables](https://docs.kupe.in/api-reference/agents/demo-variables.md): Spoken demo values for a web test call. Never returns `{{tokens}}`. - [List Agent Versions](https://docs.kupe.in/api-reference/agents/list-agent-versions.md) - [Revert Agent](https://docs.kupe.in/api-reference/agents/revert-agent.md) - [List Agent Analyses](https://docs.kupe.in/api-reference/agents/list-agent-analyses.md) - [Attach Analysis](https://docs.kupe.in/api-reference/agents/attach-analysis.md) - [Detach Analysis](https://docs.kupe.in/api-reference/agents/detach-analysis.md) - [List Agent Tools](https://docs.kupe.in/api-reference/agents/list-agent-tools.md) - [Attach Tool](https://docs.kupe.in/api-reference/agents/attach-tool.md) - [Detach Tool](https://docs.kupe.in/api-reference/agents/detach-tool.md) - [List Agent Tests](https://docs.kupe.in/api-reference/agents/list-agent-tests.md) - [Create Agent Test](https://docs.kupe.in/api-reference/agents/create-agent-test.md) - [Delete Agent Test](https://docs.kupe.in/api-reference/agents/delete-agent-test.md) - [Patch Agent Test](https://docs.kupe.in/api-reference/agents/patch-agent-test.md) - [List Agent Test Runs](https://docs.kupe.in/api-reference/agents/list-agent-test-runs.md) - [Start Agent Test Run](https://docs.kupe.in/api-reference/agents/start-agent-test-run.md) - [Get Agent Test Run](https://docs.kupe.in/api-reference/agents/get-agent-test-run.md) - [List Agent Memories](https://docs.kupe.in/api-reference/agents/list-agent-memories.md) - [Forget Agent Memories](https://docs.kupe.in/api-reference/agents/forget-agent-memories.md) - [List Analyses](https://docs.kupe.in/api-reference/analyses/list-analyses.md) - [Create Analysis](https://docs.kupe.in/api-reference/analyses/create-analysis.md) - [Get Analysis](https://docs.kupe.in/api-reference/analyses/get-analysis.md) - [Patch Analysis](https://docs.kupe.in/api-reference/analyses/patch-analysis.md) - [Archive Analysis](https://docs.kupe.in/api-reference/analyses/archive-analysis.md) - [List Analysis Tools](https://docs.kupe.in/api-reference/analyses/list-analysis-tools.md) - [Attach Analysis Tool](https://docs.kupe.in/api-reference/analyses/attach-analysis-tool.md) - [Detach Analysis Tool](https://docs.kupe.in/api-reference/analyses/detach-analysis-tool.md) - [Get Analysis](https://docs.kupe.in/api-reference/analyses/get-analysis-1.md) - [List Tools](https://docs.kupe.in/api-reference/tools/list-tools.md) - [Create Tool](https://docs.kupe.in/api-reference/tools/create-tool.md) - [Get Tool](https://docs.kupe.in/api-reference/tools/get-tool.md) - [Patch Tool](https://docs.kupe.in/api-reference/tools/patch-tool.md) - [Archive Tool](https://docs.kupe.in/api-reference/tools/archive-tool.md) - [List Audio Assets](https://docs.kupe.in/api-reference/audio-assets/list-audio-assets.md) - [Upload Audio Asset](https://docs.kupe.in/api-reference/audio-assets/upload-audio-asset.md) - [Archive Audio Asset](https://docs.kupe.in/api-reference/audio-assets/archive-audio-asset.md) - [List Knowledge Bases](https://docs.kupe.in/api-reference/knowledge-bases/list-knowledge-bases.md) - [Create Knowledge Base](https://docs.kupe.in/api-reference/knowledge-bases/create-knowledge-base.md) - [Get Knowledge Base](https://docs.kupe.in/api-reference/knowledge-bases/get-knowledge-base.md) - [Delete Knowledge Base](https://docs.kupe.in/api-reference/knowledge-bases/delete-knowledge-base.md) - [Patch Knowledge Base](https://docs.kupe.in/api-reference/knowledge-bases/patch-knowledge-base.md) - [List Knowledge Files](https://docs.kupe.in/api-reference/knowledge-bases/list-knowledge-files.md) - [Upload Knowledge File](https://docs.kupe.in/api-reference/knowledge-bases/upload-knowledge-file.md) - [Delete Knowledge File](https://docs.kupe.in/api-reference/knowledge-bases/delete-knowledge-file.md) - [Search Knowledge Base](https://docs.kupe.in/api-reference/knowledge-bases/search-knowledge-base.md) - [List Databases](https://docs.kupe.in/api-reference/databases/list-databases.md) - [Create Database](https://docs.kupe.in/api-reference/databases/create-database.md) - [Get Database](https://docs.kupe.in/api-reference/databases/get-database.md) - [Patch Database](https://docs.kupe.in/api-reference/databases/patch-database.md) - [Archive Database](https://docs.kupe.in/api-reference/databases/archive-database.md) - [List Database Agents](https://docs.kupe.in/api-reference/databases/list-database-agents.md) - [Attach Database Agent](https://docs.kupe.in/api-reference/databases/attach-database-agent.md) - [Detach Database Agent](https://docs.kupe.in/api-reference/databases/detach-database-agent.md) - [List Database Rows](https://docs.kupe.in/api-reference/databases/list-database-rows.md) - [Export Database Rows](https://docs.kupe.in/api-reference/databases/export-database-rows.md) - [List Agent Databases](https://docs.kupe.in/api-reference/databases/list-agent-databases.md) - [List Api Keys](https://docs.kupe.in/api-reference/api-keys/list-api-keys.md) - [Create Api Key](https://docs.kupe.in/api-reference/api-keys/create-api-key.md) - [Revoke Api Key](https://docs.kupe.in/api-reference/api-keys/revoke-api-key.md) - [Get Usage Cost Summary](https://docs.kupe.in/api-reference/usage/get-usage-cost-summary.md) - [Get Daily Usage](https://docs.kupe.in/api-reference/usage/get-daily-usage.md) - [List Kupe Agent Usage](https://docs.kupe.in/api-reference/usage/list-kupe-agent-usage.md) - [Get Recording](https://docs.kupe.in/api-reference/logs/get-recording.md) - [List Recordings](https://docs.kupe.in/api-reference/logs/list-recordings.md) - [Get Playback Url](https://docs.kupe.in/api-reference/logs/get-playback-url.md) - [Get Transcript](https://docs.kupe.in/api-reference/logs/get-transcript.md) - [List Tool Call Events](https://docs.kupe.in/api-reference/logs/list-tool-call-events.md) - [Tool Call Stats](https://docs.kupe.in/api-reference/logs/tool-call-stats.md) - [Create Session](https://docs.kupe.in/api-reference/sessions/create-session.md) - [List Sessions](https://docs.kupe.in/api-reference/sessions/list-sessions.md) - [Read Session](https://docs.kupe.in/api-reference/sessions/read-session.md) - [End Session](https://docs.kupe.in/api-reference/sessions/end-session.md) - [Create Realtime Session](https://docs.kupe.in/api-reference/realtime/create-realtime-session.md) - [List Providers](https://docs.kupe.in/api-reference/providers/list-providers.md) - [List Tts Voices](https://docs.kupe.in/api-reference/voices/list-tts-voices.md): Catalog voices, public cloned voices, and the caller's private clones. - [Clone Voice](https://docs.kupe.in/api-reference/voices/clone-voice.md): Clone a voice from a short reference clip. Stored — and shown everywhere in the UI/API — as a Kupe voice, not the underlying provider. - [Delete Voice](https://docs.kupe.in/api-reference/voices/delete-voice.md) - [Update Voice](https://docs.kupe.in/api-reference/voices/update-voice.md) - [Voice Usage](https://docs.kupe.in/api-reference/voices/voice-usage.md): How many live agents still use this cloned voice (owner only). - [Voice Preview](https://docs.kupe.in/api-reference/voices/voice-preview.md): Lazy-cached catalog sample (English+Hindi mix). Generated once, stored, reused. - [Speak Voice](https://docs.kupe.in/api-reference/voices/speak-voice.md): Voice Library playground — real provider TTS. Debits the org wallet. Audio is not stored. - [Create Batch](https://docs.kupe.in/api-reference/campaigns/create-batch.md) - [List Batches](https://docs.kupe.in/api-reference/campaigns/list-batches.md) - [Unhide Batches](https://docs.kupe.in/api-reference/campaigns/unhide-batches.md): Restore every hidden campaign in the project. Does not touch sessions/usage/logs. - [Campaign Analytics](https://docs.kupe.in/api-reference/campaigns/campaign-analytics.md) - [Get Batch](https://docs.kupe.in/api-reference/campaigns/get-batch.md) - [Delete Batch](https://docs.kupe.in/api-reference/campaigns/delete-batch.md): Delete only never-started draft campaigns. Ran campaigns cannot be deleted — hide them instead. - [Batch Stats](https://docs.kupe.in/api-reference/campaigns/batch-stats.md) - [Batch Live Events](https://docs.kupe.in/api-reference/campaigns/batch-live-events.md): SSE of campaign live status. Provider webhooks publish; this does not poll Postgres. - [Batch Call Analytics](https://docs.kupe.in/api-reference/campaigns/batch-call-analytics.md) - [Update Batch Schedule](https://docs.kupe.in/api-reference/campaigns/update-batch-schedule.md): Set/replace a batch's recurrence + per-period call limit. Takes effect on the next scheduler tick — does not itself start or pause the batch. - [Add Contacts Bulk](https://docs.kupe.in/api-reference/campaigns/add-contacts-bulk.md) - [Delete Contacts Bulk](https://docs.kupe.in/api-reference/campaigns/delete-contacts-bulk.md) - [List Contacts](https://docs.kupe.in/api-reference/campaigns/list-contacts.md): Offset page by default. Pass `cursor` (empty for the first page) and/or `status` for keyset pagination. - [Add Contacts Csv](https://docs.kupe.in/api-reference/campaigns/add-contacts-csv.md) - [Start Batch](https://docs.kupe.in/api-reference/campaigns/start-batch.md) - [Pause Batch](https://docs.kupe.in/api-reference/campaigns/pause-batch.md) - [Resume Batch](https://docs.kupe.in/api-reference/campaigns/resume-batch.md) - [Cancel Batch](https://docs.kupe.in/api-reference/campaigns/cancel-batch.md) - [Hide Batch](https://docs.kupe.in/api-reference/campaigns/hide-batch.md): Hide a campaign from list/UI APIs. Row stays; sessions, usage, and logs are unchanged. - [Create Recipient List](https://docs.kupe.in/api-reference/recipient-lists/create-recipient-list.md) - [List Recipient Lists](https://docs.kupe.in/api-reference/recipient-lists/list-recipient-lists.md) - [Get Recipient List](https://docs.kupe.in/api-reference/recipient-lists/get-recipient-list.md) - [Delete Recipient List](https://docs.kupe.in/api-reference/recipient-lists/delete-recipient-list.md) - [Patch Recipient List](https://docs.kupe.in/api-reference/recipient-lists/patch-recipient-list.md) - [Add Members Bulk](https://docs.kupe.in/api-reference/recipient-lists/add-members-bulk.md) - [List Members](https://docs.kupe.in/api-reference/recipient-lists/list-members.md) - [Add Members Csv](https://docs.kupe.in/api-reference/recipient-lists/add-members-csv.md) - [Delete Member](https://docs.kupe.in/api-reference/recipient-lists/delete-member.md) - [Patch Member](https://docs.kupe.in/api-reference/recipient-lists/patch-member.md) - [Attach List To Batch](https://docs.kupe.in/api-reference/recipient-lists/attach-list-to-batch.md): Copy every member of a recipient list into a draft campaign (SQL-side, scale-safe). - [Create Inbound](https://docs.kupe.in/api-reference/inbound/create-inbound.md) - [List Inbound](https://docs.kupe.in/api-reference/inbound/list-inbound.md) - [Get Inbound](https://docs.kupe.in/api-reference/inbound/get-inbound.md) - [Delete Inbound](https://docs.kupe.in/api-reference/inbound/delete-inbound.md) - [Patch Inbound](https://docs.kupe.in/api-reference/inbound/patch-inbound.md) - [List Accounts](https://docs.kupe.in/api-reference/phones/list-accounts.md) - [Create Account](https://docs.kupe.in/api-reference/phones/create-account.md) - [Get Account](https://docs.kupe.in/api-reference/phones/get-account.md) - [Delete Account](https://docs.kupe.in/api-reference/phones/delete-account.md) - [Patch Account](https://docs.kupe.in/api-reference/phones/patch-account.md) - [List Rate Limits](https://docs.kupe.in/api-reference/phones/list-rate-limits.md) - [Upsert Rate Limit](https://docs.kupe.in/api-reference/phones/upsert-rate-limit.md) - [Delete Rate Limit](https://docs.kupe.in/api-reference/phones/delete-rate-limit.md) - [Search Numbers](https://docs.kupe.in/api-reference/phones/search-numbers.md) - [Purchase Number](https://docs.kupe.in/api-reference/phones/purchase-number.md) - [Compliance Requirements](https://docs.kupe.in/api-reference/phones/compliance-requirements.md) - [Compliance Status](https://docs.kupe.in/api-reference/phones/compliance-status.md) - [Submit Compliance](https://docs.kupe.in/api-reference/phones/submit-compliance.md) - [Refresh Compliance](https://docs.kupe.in/api-reference/phones/refresh-compliance.md) - [List Toolkits](https://docs.kupe.in/api-reference/composio/list-toolkits.md) - [List Toolkit Tools](https://docs.kupe.in/api-reference/composio/list-toolkit-tools.md) - [List Connections](https://docs.kupe.in/api-reference/composio/list-connections.md) - [Connect](https://docs.kupe.in/api-reference/composio/connect.md) - [Refresh Connection](https://docs.kupe.in/api-reference/composio/refresh-connection.md) - [Disconnect](https://docs.kupe.in/api-reference/composio/disconnect.md) - [Attach Tool](https://docs.kupe.in/api-reference/composio/attach-tool.md) - [Health](https://docs.kupe.in/api-reference/health/health.md) - [Ready](https://docs.kupe.in/api-reference/health/ready.md) ## OpenAPI Specs - [openapi](https://docs.kupe.in/openapi.yaml) ## Optional - [Console](https://hub.kupe.in)