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.

Setup#

Install the MCP server:

bash

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

Then set your API key:

bash

export BOTCALL_API_KEY="bs_live_..."

Or add to Claude Desktop config ( ~/Library/Application Support/Claude/claude_desktop_config.json):

json

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

Get an API Key#

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

Tools#

ToolDescriptionprovision_numberProvision a new phone number (optional: area code, country)list_numbersList your provisioned phone numbersrelease_numberRelease a phone numberget_inboxGet recent SMS messagesget_codeWait for an SMS and extract the verification code (long-polls up to 30s)get_usageGet your plan, limits, and usage stats

Example Workflow#

1. Call provision_number to get a phone number
2. Use the number to sign up for a service that requires SMS verification
3. Call get_code — it waits for the SMS and returns the extracted code
4. Enter the code to complete verification

Environment Variables#

VariableDescriptionBOTCALL_API_KEYRequired. Your API key from botcall.ioBOTCALL_API_URLAPI base URL (default: https://api.botcall.io)

Resources#

• botcall.io — sign up and manage your account
• GitHub — source code
• npm — package