Skip to content

Bolna MCP

The Bolna MCP server for voice AI agents.

Build voice agents, place phone calls and read transcripts by asking Claude, Cursor or any MCP client. Hosted at mcp.bolna.ai, so there is nothing to install.

# Add Bolna to Claude Codeclaude mcp add --transport http bolna \  "https://mcp.bolna.ai/api/mcp" \  --header "Authorization: Bearer <BOLNA_API_KEY>" \  --scope user# Then just ask> Create a Hindi agent that reminds customers about EMIs

Bolna MCP lets your AI assistant build and run voice agents from a chat.

  • What it is

    A remote MCP server at mcp.bolna.ai with 115 tools for agents, calls, batches, workflows, knowledge bases, phone numbers, SIP trunks and sub-accounts. It calls the Bolna REST API for you and is open source.

  • Who it is for

    Developers who work in Claude Code, Cursor, Windsurf, Codex or Zed, and anyone who would rather describe a voice agent in Claude than click through settings.

  • What you need

    A Bolna account and an API key, or one click in Claude’s connector directory. Your key travels with each request and is never stored on the server.

Connect Bolna to your assistant in under a minute

  1. Step 01

    Get an API key

    Sign up free and copy a key from Developers → API Keys in the Bolna dashboard. A sub-account key works too.

  2. Step 02

    Add the server

    Point your MCP client at https://mcp.bolna.ai/api/mcp with the key as a Bearer token, or add Bolna from Claude’s connector directory.

  3. Step 03

    Ask in plain words

    The assistant picks the tools and chains them. Try List my agents Call my number Why did my last call fail?

What you can do with the Bolna MCP server

  • Agents

    Build and change voice agents

    Describe the agent you want in plain words. The assistant creates it, or changes its prompt, voice, language or models, through the Bolna API.

    Try asking

    “Create a Hindi lead qualification agent that uses Sarvam for speech and GPT-4o mini, and greets callers by name.”

  • Graph agents

    Design multi-step call flows

    Ask for a node-based call flow with branches, transfers and fallbacks. Nodes and edges are checked against the editor’s rules before they are saved.

    Try asking

    “Build a graph agent that books dental appointments, with an after-hours branch and a transfer after three silent turns.”

  • Conversations

    Start and debug phone conversations

    Place outbound phone calls and read every conversation’s history, recording and transcript, without opening the dashboard.

    Try asking

    “Show me the last five conversations for my support agent and read the transcript of any call that failed.”

  • Batches and workflows

    Run campaigns from a CSV

    Upload a CSV as a batch and schedule it, or build a workflow that calls, retries and follows up on WhatsApp, then start it as a campaign.

    Try asking

    “Create a batch from leads.csv for my EMI reminder agent and schedule it for 9 AM tomorrow.”

  • Telephony

    Manage numbers, SIP trunks and sub-accounts

    Buy and route phone numbers, connect SIP trunks and check what each sub-account has used, from the same chat.

    Try asking

    “Buy a US number, route it to my support agent and add it to my Twilio trunk.”

  • Knowledge and docs

    Add a knowledge base and look up the docs

    Give an agent a knowledge base, and have the assistant read the actual Bolna docs instead of guessing from its training data.

    Try asking

    “Add our pricing page as a knowledge base for the sales agent, then check the docs for how to set up call transfer.”

Bolna MCP tools, grouped by what they manage

115 account tools in all. See the full tool list and the prompt cheatsheet.

Bolna MCP server tool groups and example prompts
Tool groupWhat the assistant can doExample prompt
AgentsList, view, create, update and delete voice agents“Create a Tamil COD confirmation agent”
Graph agentsBuild and edit node-based call flows“Add a node that handles refund questions”
CallsStart calls and read call history, recordings and transcripts“Call +91XXXXXXXXXX with my demo agent”
BatchesCreate, schedule and track batch calling campaigns“Schedule this CSV for 9 AM tomorrow”
WorkflowsAuthor, publish and run multi-step automations and campaigns“Retry in an hour if there’s no answer”
DispositionsSet up the fields captured after every call“Capture appointment_time from each call”
Knowledge basesCreate a knowledge base from a URL or file and check its status“Make a knowledge base from our pricing page”
Phone numbers and SIP trunksBuy numbers, link them to agents and manage trunks“Route my new number to the support agent”
Sub-accounts and accountCheck balance, usage and switch sub-accounts per call“What’s my wallet balance?”
ViolationsReview calls flagged for policy, regulatory or fraud review“List any pending violations”

Works with every MCP client

Setup for each client is in the MCP quickstart.

MCP clients supported by the Bolna MCP server and how to connect each
ClientHow to connect
Claude (web, desktop, mobile)Add Bolna from the Claude connector directory and sign in
Claude Codeclaude mcp add --transport http bolna with your Bearer key
Claude DesktopUse the mcp-remote bridge in claude_desktop_config.json
CursorAdd the URL and header to .cursor/mcp.json
WindsurfAdd serverUrl and the header to mcp_config.json
Codex, Zed and othersStreamable HTTP at https://mcp.bolna.ai/api/mcp with the Bearer header

Frequently Asked Questions

The Bolna MCP server is a hosted Model Context Protocol server at mcp.bolna.ai. It lets AI assistants such as Claude, Cursor, Windsurf and Codex manage your Bolna account: build voice agents, place phone calls, run batches and workflows, and read transcripts, all from a chat.