English Français العربية

io.github.danecodes/botcall-mcp

السجل الرسمي الأمن

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package botcall-mcp
Claude Code 
claude mcp add botcall-mcp -e 'BOTCALL_API_KEY=<your botcall_api_key>' -- npx -y botcall-mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "botcall-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "botcall-mcp@0.1.2"
            ],
            "env": {
                "BOTCALL_API_KEY": "<your botcall_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • BOTCALL_API_KEY إلزامي سري Your botcall API key from botcall.io

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. botcall-mcp
  2. Setup
  3. Get an API key
  4. Tools
  5. Example
  6. Environment variables
  7. License

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

الأسئلة الشائعة

ما هو io.github.danecodes/botcall-mcp؟

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

كيف أثبّت io.github.danecodes/botcall-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add botcall-mcp -e 'BOTCALL_API_KEY=<your botcall_api_key>' -- npx -y botcall-mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.danecodes/botcall-mcp إلى مفتاح API؟

نعم. يتطلب BOTCALL_API_KEY، وتضبطها في إعداداته.

هل io.github.danecodes/botcall-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.danecodes/botcall-mcp؟

ينشره danecodes. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.