Back to Browse

Botcall MCP Server

Developer ToolsLow Risk8.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

8.0
Low Risk8.0Low Risk

Valid MCP server (2 strong, 4 medium validity signals). 2 known CVEs in dependencies (0 critical, 2 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

3 files analyzed · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your botcall API key from botcall.ioRequired

Environment variable: BOTCALL_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-danecodes-botcall-mcp": {
      "env": {
        "BOTCALL_API_KEY": "your-botcall-api-key-here"
      },
      "args": [
        "-y",
        "botcall-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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.

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

Reviews

No reviews yet

Be the first to review this server!

Botcall MCP Server - Give your AI agent a real phone number for SMS verification | MCP Marketplace