MCP Server — Overview & Setup | Voicebip

The Voicebip MCP server exposes 38 tools that let AI assistants manage agents, provision numbers, make calls, send messages, manage subscriptions, and control 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_KEY": "pk_live_your_key"
8       }
9     }
10   }
11 }

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
`voicebip_list_templates`	List available agent templates

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_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 section. Each MCP tool maps to a REST endpoint documented there.