English Français العربية

io.github.danecodes/botcall-mcp

Official registry Security

Give your AI agent a real phone number for SMS verification codes.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package botcall-mcp
Claude Code 
claude mcp add botcall-mcp -e 'BOTCALL_API_KEY=<your botcall_api_key>' -- npx -y botcall-mcp@0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "botcall-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "botcall-mcp@0.1.2"
            ],
            "env": {
                "BOTCALL_API_KEY": "<your botcall_api_key>"
            }
        }
    }
}

Environment variables

  • BOTCALL_API_KEY required secret Your botcall API key from botcall.io

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. botcall-mcp
  2. Setup
  3. Get an API key
  4. Tools
  5. Example
  6. Environment variables
  7. License

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.

ParameterTypeDescription
areaCodestringPreferred area code, e.g. "206" (optional)
countrystringISO country code (default: "US")
get_code

Wait for an incoming SMS and extract the verification code. Long-polls until a message arrives or the timeout expires.

ParameterTypeDescription
timeoutnumberSeconds to wait (default: 30, max: 30)
numberIdstringFilter to a specific number (optional)
get_inbox

Get recent SMS messages received on your numbers.

ParameterTypeDescription
limitnumberMax messages to return (default: 10)
numberIdstringFilter to a specific number (optional)
list_numbers

List all your provisioned phone numbers. No parameters.

release_number

Release a phone number you no longer need.

ParameterTypeDescription
numberIdstringRequired. The number ID to release
get_usage

Get your current plan, limits, and usage stats. No parameters.

Example

You: Sign up for ExampleService using a phone number

Agent: I'll provision a number and handle the verification.

→ provision_number({ areaCode: "415" })
  { number: "+14155550123", id: "pn_abc123" }

→ [agent enters the number on ExampleService's signup page]

→ get_code({ numberId: "pn_abc123" })
  Verification code: 847291

→ [agent enters 847291 to complete verification]

Environment variables

VariableDescription
BOTCALL_API_KEYRequired. Your API key from botcall.io
BOTCALL_API_URLAPI base URL (default: https://api.botcall.io)

License

MIT

Frequently asked questions

What is io.github.danecodes/botcall-mcp?

Give your AI agent a real phone number for SMS verification codes.

How do I install io.github.danecodes/botcall-mcp?

It runs on your machine. In Claude Code: claude mcp add botcall-mcp -e 'BOTCALL_API_KEY=<your botcall_api_key>' -- npx -y botcall-mcp@0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.danecodes/botcall-mcp need an API key?

Yes. It expects BOTCALL_API_KEY, which you set in its configuration.

Is io.github.danecodes/botcall-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.danecodes/botcall-mcp?

It is published by danecodes. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.