MCP Server

MCP Server — Overview & Setup

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

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

1{
2  "mcpServers": {
3    "voicebip": {
4      "command": "npx",
5      "args": ["-y", "voicebip-mcp"],
6      "env": {
7        "VOICEBIP_API_URL": "https://api.voicebip.com/v1",
8        "VOICEBIP_API_KEY": "pk_live_your_key"
9      }
10    }
11  }
12}

Available Tools

Agents

ToolDescription
voicebip_create_agentCreate a new AI agent
voicebip_list_agentsList all agents in your workspace
voicebip_get_agentGet a single agent by ID
voicebip_update_agentUpdate agent configuration
voicebip_delete_agentDelete an agent
voicebip_toggle_agent_shareableEnable or disable the public shareable link
voicebip_export_conversationsExport conversation history as CSV or JSON

API Keys

ToolDescription
voicebip_create_api_keyCreate a new API key
voicebip_list_api_keysList all API keys in the workspace
voicebip_revoke_api_keyPermanently revoke an API key
voicebip_rotate_api_keyRotate an API key (revoke + create replacement)

Phone Numbers

ToolDescription
voicebip_list_available_numbersBrowse available numbers in the inventory
voicebip_provision_numberProvision a phone number for an agent
voicebip_get_numberGet a provisioned number by ID
voicebip_release_numberRelease a provisioned number back to the pool

Calls

ToolDescription
voicebip_make_callInitiate an outbound voice call
voicebip_get_callGet call details and status
voicebip_end_callEnd an active call
voicebip_get_call_recordingRetrieve a call recording
voicebip_hold_callPlace an active call on hold
voicebip_resume_callResume a held call
voicebip_transfer_callTransfer a call to another number
voicebip_send_dtmfInject DTMF tones into a call

Messaging

ToolDescription
voicebip_send_messageSend an SMS or WhatsApp message
voicebip_get_conversationGet conversation history
voicebip_list_conversationsList conversations for an agent or workspace
voicebip_update_conversation_modeUpdate the AI mode for a conversation
voicebip_send_templateSend a WhatsApp template message

Knowledge Bases

ToolDescription
voicebip_create_knowledge_baseCreate a knowledge base for RAG
voicebip_list_knowledge_basesList knowledge bases in the workspace
voicebip_upload_knowledge_documentIngest a document (URL ingests immediately; file sources return a presigned upload URL)
voicebip_complete_knowledge_documentFinalize a file-based document after the client PUTs it
voicebip_get_document_statusCheck ingestion/embedding status of a document
voicebip_query_knowledge_baseRun a similarity query against a knowledge base
voicebip_attach_knowledge_baseAttach or detach a knowledge base from an agent

Voices

ToolDescription
voicebip_list_voicesList available TTS voices (voice IDs for an agent’s tts_voice)

Billing & Analytics

ToolDescription
voicebip_get_analyticsRetrieve workspace analytics
voicebip_get_usageGet current billing period usage
voicebip_get_subscriptionGet the active subscription plan
voicebip_update_subscriptionSwitch between Starter, Builder, and Scale plans

Webhooks & Routing

ToolDescription
voicebip_test_webhookSend a test webhook event with mock Nigerian payload
voicebip_list_templatesList available agent templates
voicebip_list_routing_rulesList all inbound call routing rules
voicebip_create_routing_ruleCreate a new routing rule
voicebip_update_routing_ruleUpdate a routing rule
voicebip_delete_routing_ruleDelete 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 section. Each MCP tool maps to a REST endpoint documented there.