Botcall Mcp

authSTDIOregistry active

Summary

Wraps the Botcall API so Claude can provision real phone numbers, receive SMS messages, and extract verification codes through tool calls. Five tools cover the workflow: provision_number lets you request a number by area code, get_code long-polls for incoming messages and parses out the verification code, get_inbox retrieves message history, list_numbers shows what you've provisioned, and release_number cleans up when you're done. Useful when you need to automate signups or test SMS-based auth flows without manual phone access. Requires a Botcall API key and runs over stdio transport.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

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

Tools

`provision_number`

Provision a new phone number for receiving SMS.

Parameter	Type	Description
`areaCode`	string	Preferred area code, e.g. `"206"` (optional)
`country`	string	ISO 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.

Parameter	Type	Description
`timeout`	number	Seconds to wait (default: 30, max: 30)
`numberId`	string	Filter to a specific number (optional)

`get_inbox`

Get recent SMS messages received on your numbers.

Parameter	Type	Description
`limit`	number	Max messages to return (default: 10)
`numberId`	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
`numberId`	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
`BOTCALL_API_KEY`	Required. Your API key from botcall.io
`BOTCALL_API_URL`	API base URL (default: `https://api.botcall.io`)

License

MIT

Featured

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

Configuration

BOTCALL_API_KEY*secret

Your 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.

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

Tools

`provision_number`

Provision a new phone number for receiving SMS.

Parameter	Type	Description
`areaCode`	string	Preferred area code, e.g. `"206"` (optional)
`country`	string	ISO 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.

Parameter	Type	Description
`timeout`	number	Seconds to wait (default: 30, max: 30)
`numberId`	string	Filter to a specific number (optional)

`get_inbox`

Get recent SMS messages received on your numbers.

Parameter	Type	Description
`limit`	number	Max messages to return (default: 10)
`numberId`	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
`numberId`	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
`BOTCALL_API_KEY`	Required. Your API key from botcall.io
`BOTCALL_API_URL`	API base URL (default: `https://api.botcall.io`)

License

MIT

Botcall Mcp

botcall-mcp

Setup

Claude Desktop

Claude Code

Other MCP clients

Get an API key

Tools

`provision_number`

`get_code`

`get_inbox`

`list_numbers`

`release_number`

`get_usage`

Example

Environment variables

License

Configuration

Botcall Mcp

botcall-mcp

Setup

Claude Desktop

Claude Code

Other MCP clients

Get an API key

Tools

`provision_number`

`get_code`

`get_inbox`

`list_numbers`

`release_number`

`get_usage`

Example

Environment variables

License

Configuration

Related AI & LLM Tools MCP Servers

Related AI & LLM Tools MCP Servers