- name
- botcall-mcp
- description
- Give your AI agent a real phone number for SMS verification. Provisions numbers, receives SMS, and extracts verification codes via the botcall API. Requires a BOTCALL_API_KEY from botcall.io.
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:
claude mcp add botcall -- npx -y botcall-mcpThen set your API key:
export BOTCALL_API_KEY="bs_live_..."Or add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.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
| Tool | Description |
|---|---|
provision_number | Provision a new phone number (optional: area code, country) |
list_numbers | List your provisioned phone numbers |
release_number | Release a phone number |
get_inbox | Get recent SMS messages |
get_code | Wait for an SMS and extract the verification code (long-polls up to 30s) |
get_usage | Get your plan, limits, and usage stats |
Example Workflow
- Call
provision_numberto get a phone number - Use the number to sign up for a service that requires SMS verification
- Call
get_code— it waits for the SMS and returns the extracted code - Enter the code to complete verification
Environment Variables
| Variable | Description |
|---|---|
BOTCALL_API_KEY | Required. Your API key from botcall.io |
BOTCALL_API_URL | API base URL (default: https://api.botcall.io) |
Resources
- botcall.io — sign up and manage your account
- GitHub — source code
- npm — package