Botcall Mcp

io.github.danecodesPublished by GitHub account danecodesv0.1.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

A local MCP server that gives an AI assistant real phone numbers to receive SMS and extract verification codes through tool calls.

What you can do
Provision a new phone number, optionally with a preferred area code and country, and list or release numbers you hold. Wait for an incoming SMS and extract the verification code, or read recent messages in the inbox. Check the current plan, limits and usage stats.
When to use it
Useful when an assistant needs to complete phone-based signups or SMS verification on your behalf, or when you want to check codes and messages arriving on numbers you rent through the service.
Requirements
Runs locally via npx (Node.js) over stdio. Requires a Botcall account and API key supplied in the BOTCALL_API_KEY environment variable; the API base URL can be overridden with BOTCALL_API_URL. Network access to the Botcall API is needed.
Before you install
Provisioning numbers and using the service likely incurs charges under your plan, so check limits with the usage tool. The API key is a secret placed in the client configuration. Releasing a number is destructive and may lose access to messages on it. Phone numbers and received SMS are handled by the third-party Botcall service.

Installation

In SourceWeft

  1. Open Botcall Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

json
{  "mcpServers": {    "botcall": {      "command": "npx",      "args": ["-y", "botcall-mcp"],      "env": {        "BOTCALL_API_KEY": "bs_live_..."      }    }  }}

Claude Code

bash
claude mcp add botcall -- npx -y botcall-mcp

Then set your API key in the environment:

bash
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

Source: README.md at commit 55ef6c1

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.