VoIPbin MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to interact with the VoIPbin CPaaS platform. It exposes VoIPbin's communication APIs -- calls, flows, messaging, conferencing, AI, and more -- as tools that any MCP-compatible client can use to manage and automate cloud communications.

Installation

pip install voipbin-mcp

Or run directly without installing:

uvx voipbin-mcp

Configuration

Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "voipbin": {
      "command": "uvx",
      "args": ["voipbin-mcp"],
      "env": {
        "VOIPBIN_API_KEY": "your-access-key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project directory:

{
  "mcpServers": {
    "voipbin": {
      "command": "uvx",
      "args": ["voipbin-mcp"],
      "env": {
        "VOIPBIN_API_KEY": "your-access-key"
      }
    }
  }
}

Generic MCP Client

Any MCP-compatible client can connect by running the voipbin-mcp command with the VOIPBIN_API_KEY environment variable set:

VOIPBIN_API_KEY=your-access-key voipbin-mcp

Available Tools

Example Usage

Once configured, you can ask your AI assistant to interact with VoIPbin directly:

List active calls:

"Show me all my active calls"

The AI uses list_calls to fetch and display your current calls.

Create a flow:

"Create a flow that answers and plays a greeting"

The AI uses create_flow to build a call flow with answer and play actions.

Check billing:

"What are my recent billing charges?"

The AI uses list_billings to retrieve your billing history.

Manage contacts:

"Add a new contact named John with phone number +1234567890"

The AI uses create_contact to create the contact in your account.

Security Note

Your VoIPbin API key is sent as a URL query parameter (accesskey=) on every request. The connection uses HTTPS, so the key is encrypted in transit. However, be aware that URL parameters may be recorded in server access logs and proxy logs. Avoid sharing unredacted debug output, and rotate your key if you suspect it has been exposed.

Getting an API Key

Sign up at voipbin.net and create an access key through the API or the admin console at admin.voipbin.net.

Development

git clone https://github.com/voipbin/mcp.git
cd mcp
uv venv
uv pip install -e ".[dev]"
uv run pytest tests/ -v

License

MIT