danecodes avatar

Botcall Mcp

danecodes/botcall-mcp

Wraps the Botcall API so Claude can provision real phone numbers, receive SMS messages, and extract verification codes through tool calls. Five tools cover the workflow: provision_number lets you request a number by area code, get_code long-polls for incoming messages and parses out the verification code, get_inbox retrieves message history, list_numbers shows what you've provisioned, and release_number cleans up when you're done. Useful when you need to automate signups or test SMS-based auth flows without manual phone access. Requires a Botcall API key and runs over stdio transport.

tools
6
auth
Secret needed
transport
STDIO
env var
1
last updated
Apr 5, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

provision_numberProvision a new phone number for receiving SMS.

Provision a new phone number for receiving SMS.

No parameter schema in public metadata yet.

get_codeWait for an incoming SMS and extract the verification code.

Wait for an incoming SMS and extract the verification code.

No parameter schema in public metadata yet.

get_inboxGet recent SMS messages received on your numbers.

Get recent SMS messages received on your numbers.

No parameter schema in public metadata yet.

list_numbersList all your provisioned phone numbers.

List all your provisioned phone numbers.

No parameter schema in public metadata yet.

release_numberRelease a phone number you no longer need.

Release a phone number you no longer need.

No parameter schema in public metadata yet.

get_usageGet your current plan, limits, and usage stats.

Get your current plan, limits, and usage stats.

No parameter schema in public metadata yet.

Sponsors

Configuration

BOTCALL_API_KEY*secret

Your botcall API key from botcall.io

Readme

botcall-mcp

An MCP server that gives AI agents real phone numbers. Provision a number, receive SMS, and extract verification codes — all through tool calls.

Built for Claude Desktop, Claude Code, and any MCP-compatible client.

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "botcall": {
      "command": "npx",
      "args": ["-y", "botcall-mcp"],
      "env": {
        "BOTCALL_API_KEY": "bs_live_..."
      }
    }
  }
}

Claude Code

claude mcp add botcall -- npx -y botcall-mcp

Then set your API key in the environment:

export BOTCALL_API_KEY="bs_live_..."

Other MCP clients

Any client that supports the MCP stdio transport works. Run npx botcall-mcp with BOTCALL_API_KEY set.

Get an API key

Sign up at botcall.io, pick a plan, and grab your key from Dashboard → API Keys.

Tools

provision_number

Provision a new phone number for receiving SMS.


View the full README on GitHub

Details

Repository
github.com/danecodes/botcall-mcp
Categories
AI & LLM Tools, Communication & Messaging
Package
botcall-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1danielguru avatarRepomemorydanielguru/repomemoryPersistent memory for AI coding agents. Hybrid search, auto-session capture, context routing.0stars
2dbsectrainer avatarMcp Eval Runnerdbsectrainer/mcp-eval-runnerA standardized testing harness for MCP servers and agent workflows0stars
3vickhunter avatarAllagiovickhunter/allagio-pluginAgent-to-agent partnerships on ORP: find counterparties, negotiate deals, settle.0stars
4slipstack avatarSlipstack PDFdev.slipstack/pdfGenerate invoice and receipt PDFs from JSON. Agent-callable document API with a free demo quota.0stars
5sunrays avatarSunrays — Local Service Bookingdev.sunrays/bookingBook local tradespeople — plumber, electrician, HVAC, and 7 more — via your AI agent. All US.0stars
6true402 avatarMcp Servertrue402/mcp-serverPay-per-call AI + web + on-chain tools over x402 (USDC on Base): LLM, SEO, extract, token safety.0stars