botcall-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@botcall-mcp Provision a US number and wait for an SMS verification code."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpThen 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.
Related MCP server: agentline-mcp
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.
Parameter | Type | Description |
| string | Preferred area code, e.g. |
| string | ISO country code (default: |
get_code
Wait for an incoming SMS and extract the verification code. Long-polls until a message arrives or the timeout expires.
Parameter | Type | Description |
| number | Seconds to wait (default: 30, max: 30) |
| string | Filter to a specific number (optional) |
get_inbox
Get recent SMS messages received on your numbers.
Parameter | Type | Description |
| number | Max messages to return (default: 10) |
| string | Filter 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.
Parameter | Type | Description |
| string | Required. 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
Variable | Description |
| Required. Your API key from botcall.io |
| API base URL (default: |
License
MIT
Available Tools
6 toolsget_codeA
Wait for an incoming SMS and extract the verification code. Use this after triggering a verification flow — it long-polls until a message arrives or the timeout expires.
Inputs: timeout, numberId.
get_inboxA
Get recent SMS messages received on your numbers.
Inputs: limit, numberId.
get_usageA
Get your current plan, limits, and usage statistics.
Inputs: no named parameters.
list_numbersA
List all phone numbers you have provisioned.
Inputs: no named parameters.
provision_numberB
Provision a new phone number for receiving SMS. Returns the number details including the E.164 phone number.
Inputs: country, areaCode.
release_numberB
Release a phone number you no longer need.
Inputs: numberId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clear, distinct purpose: waiting for a code, viewing inbox, usage stats, listing numbers, provisioning, and releasing numbers. No overlap in functionality.
All tool names follow a consistent verb_noun pattern in snake_case, using verbs like get, list, provision, release. No mixing of conventions.
With 6 tools, the set is well-scoped for an SMS verification and number management server. Each tool serves a necessary role without excess or deficiency.
The tool surface covers the full lifecycle of number management (list, provision, release) and SMS retrieval (inbox, code waiting) along with usage tracking. No obvious gaps for the stated purpose.
Related MCP Connectors
Rent real and virtual phone numbers in 14 countries and read their SMS from your AI agent.
Give any AI agent a phone: make and answer calls, get through phone menus, and send texts.
Phone numbers for AI agents: SMS verification codes and rented numbers that receive SMS.
Virtual phone numbers and SMS verification codes for AI agents: 800+ services, 200+ countries.
Related MCP Servers
- AlicenseAqualityBmaintenanceVirtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle.662 npm4MIT
- AlicenseAqualityCmaintenanceGives AI agents phone numbers, email, SMS, and voice calls as MCP tools, enabling them to provision numbers, capture 2FA codes, send messages, and make calls.15MIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage phone numbers, send/receive SMS, and place voice calls through natural language, connecting to the phone network via the AgentPhone API.28364 npm126MIT

VoidMob MCPofficial
AlicenseAqualityBmaintenancePhone numbers, mobile IPs and eSIMs for your AI agent.28181 npm22MIT