> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.voicebip.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.voicebip.com/_mcp/server.

# MCP Server — Overview & Setup

> Use Voicebip from Cursor, Claude Desktop, or any MCP-compatible AI tool.

The Voicebip MCP server exposes 46 tools that let AI assistants manage agents, provision numbers, make calls, send messages, manage subscriptions, knowledge bases, voices, and routing rules using natural language.

## Setup

> **Note**
>
> `voicebip-mcp` is not yet published to npm. Use the **local build** instructions below until the package is available.

```json
{
  "mcpServers": {
    "voicebip": {
      "command": "npx",
      "args": ["-y", "voicebip-mcp"],
      "env": {
        "VOICEBIP_API_URL": "https://api.voicebip.com/v1",
        "VOICEBIP_API_KEY": "pk_live_your_key"
      }
    }
  }
}
```

## Available Tools

### Agents

| Tool                              | Description                                 |
| --------------------------------- | ------------------------------------------- |
| `voicebip_create_agent`           | Create a new AI agent                       |
| `voicebip_list_agents`            | List all agents in your workspace           |
| `voicebip_get_agent`              | Get a single agent by ID                    |
| `voicebip_update_agent`           | Update agent configuration                  |
| `voicebip_delete_agent`           | Delete an agent                             |
| `voicebip_toggle_agent_shareable` | Enable or disable the public shareable link |
| `voicebip_export_conversations`   | Export conversation history as CSV or JSON  |

### API Keys

| Tool                      | Description                                     |
| ------------------------- | ----------------------------------------------- |
| `voicebip_create_api_key` | Create a new API key                            |
| `voicebip_list_api_keys`  | List all API keys in the workspace              |
| `voicebip_revoke_api_key` | Permanently revoke an API key                   |
| `voicebip_rotate_api_key` | Rotate an API key (revoke + create replacement) |

### Phone Numbers

| Tool                              | Description                                   |
| --------------------------------- | --------------------------------------------- |
| `voicebip_list_available_numbers` | Browse available numbers in the inventory     |
| `voicebip_provision_number`       | Provision a phone number for an agent         |
| `voicebip_get_number`             | Get a provisioned number by ID                |
| `voicebip_release_number`         | Release a provisioned number back to the pool |

### Calls

| Tool                          | Description                       |
| ----------------------------- | --------------------------------- |
| `voicebip_make_call`          | Initiate an outbound voice call   |
| `voicebip_get_call`           | Get call details and status       |
| `voicebip_end_call`           | End an active call                |
| `voicebip_get_call_recording` | Retrieve a call recording         |
| `voicebip_hold_call`          | Place an active call on hold      |
| `voicebip_resume_call`        | Resume a held call                |
| `voicebip_transfer_call`      | Transfer a call to another number |
| `voicebip_send_dtmf`          | Inject DTMF tones into a call     |

### Messaging

| Tool                                | Description                                  |
| ----------------------------------- | -------------------------------------------- |
| `voicebip_send_message`             | Send an SMS or WhatsApp message              |
| `voicebip_get_conversation`         | Get conversation history                     |
| `voicebip_list_conversations`       | List conversations for an agent or workspace |
| `voicebip_update_conversation_mode` | Update the AI mode for a conversation        |
| `voicebip_send_template`            | Send a WhatsApp template message             |

### Knowledge Bases

| Tool                                   | Description                                                                             |
| -------------------------------------- | --------------------------------------------------------------------------------------- |
| `voicebip_create_knowledge_base`       | Create a knowledge base for RAG                                                         |
| `voicebip_list_knowledge_bases`        | List knowledge bases in the workspace                                                   |
| `voicebip_upload_knowledge_document`   | Ingest a document (URL ingests immediately; file sources return a presigned upload URL) |
| `voicebip_complete_knowledge_document` | Finalize a file-based document after the client PUTs it                                 |
| `voicebip_get_document_status`         | Check ingestion/embedding status of a document                                          |
| `voicebip_query_knowledge_base`        | Run a similarity query against a knowledge base                                         |
| `voicebip_attach_knowledge_base`       | Attach or detach a knowledge base from an agent                                         |

### Voices

| Tool                   | Description                                                      |
| ---------------------- | ---------------------------------------------------------------- |
| `voicebip_list_voices` | List available TTS voices (voice IDs for an agent's `tts_voice`) |

### Billing & Analytics

| Tool                           | Description                                      |
| ------------------------------ | ------------------------------------------------ |
| `voicebip_get_analytics`       | Retrieve workspace analytics                     |
| `voicebip_get_usage`           | Get current billing period usage                 |
| `voicebip_get_subscription`    | Get the active subscription plan                 |
| `voicebip_update_subscription` | Switch between Starter, Builder, and Scale plans |

### Webhooks & Routing

| Tool                           | Description                                          |
| ------------------------------ | ---------------------------------------------------- |
| `voicebip_test_webhook`        | Send a test webhook event with mock Nigerian payload |
| `voicebip_list_templates`      | List available agent templates                       |
| `voicebip_list_routing_rules`  | List all inbound call routing rules                  |
| `voicebip_create_routing_rule` | Create a new routing rule                            |
| `voicebip_update_routing_rule` | Update a routing rule                                |
| `voicebip_delete_routing_rule` | Delete a routing rule                                |

## Natural Language Examples

* *"Create an agent called Customer Support"*
* *"Provision a Lagos phone number for my agent"*
* *"Make a call from +2348031234567 to +2348061234567"*
* *"Send an SMS saying 'Your order is ready' to +2348091234567"*
* *"Switch my workspace to the Builder plan"*
* *"Show me my usage for this billing period"*
* *"Create a routing rule that sends calls mentioning 'billing' to my finance agent"*

For detailed API reference, see the [API Reference](/api-reference) section. Each MCP tool maps to a REST endpoint documented there.