{
  "markdown": "# botcall-mcp\n\nAn MCP server that gives AI agents real phone numbers. Provision a number, receive SMS, and extract verification codes — all through tool calls.\n\nBuilt for [Claude Desktop](https://claude.ai/download), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and any MCP-compatible client.\n\n## Setup\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"botcall\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"botcall-mcp\"],\n      \"env\": {\n        \"BOTCALL_API_KEY\": \"bs_live_...\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add botcall -- npx -y botcall-mcp\n```\n\nThen set your API key in the environment:\n\n```bash\nexport BOTCALL_API_KEY=\"bs_live_...\"\n```\n\n### Other MCP clients\n\nAny client that supports the [MCP stdio transport](https://modelcontextprotocol.io) works. Run `npx botcall-mcp` with `BOTCALL_API_KEY` set.\n\n## Get an API key\n\nSign up at [botcall.io](https://botcall.io), pick a plan, and grab your key from Dashboard → API Keys.\n\n## Tools\n\n### `provision_number`\n\nProvision a new phone number for receiving SMS.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `areaCode` | string | Preferred area code, e.g. `\"206\"` (optional) |\n| `country` | string | ISO country code (default: `\"US\"`) |\n\n### `get_code`\n\nWait for an incoming SMS and extract the verification code. Long-polls until a message arrives or the timeout expires.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `timeout` | number | Seconds to wait (default: 30, max: 30) |\n| `numberId` | string | Filter to a specific number (optional) |\n\n### `get_inbox`\n\nGet recent SMS messages received on your numbers.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `limit` | number | Max messages to return (default: 10) |\n| `numberId` | string | Filter to a specific number (optional) |\n\n### `list_numbers`\n\nList all your provisioned phone numbers. No parameters.\n\n### `release_number`\n\nRelease a phone number you no longer need.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `numberId` | string | **Required.** The number ID to release |\n\n### `get_usage`\n\nGet your current plan, limits, and usage stats. No parameters.\n\n## Example\n\n```\nYou: Sign up for ExampleService using a phone number\n\nAgent: I'll provision a number and handle the verification.\n\n→ provision_number({ areaCode: \"415\" })\n  { number: \"+14155550123\", id: \"pn_abc123\" }\n\n→ [agent enters the number on ExampleService's signup page]\n\n→ get_code({ numberId: \"pn_abc123\" })\n  Verification code: 847291\n\n→ [agent enters 847291 to complete verification]\n```\n\n## Environment variables\n\n| Variable | Description |\n|----------|-------------|\n| `BOTCALL_API_KEY` | **Required.** Your API key from botcall.io |\n| `BOTCALL_API_URL` | API base URL (default: `https://api.botcall.io`) |\n\n## License\n\nMIT\n",
  "bytes": 2942,
  "sha": "9511496a7e396e505016da63cc23698006c9fb07b7c26eff0f8934a21a46a15e",
  "repo_slug": "danecodes/botcall-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_danecodes_botcall_mcp_0d032655/readme"
}