A Guide to Model Context Protocol (MCP) Server for Local LLMs
The temphonenumber Model Context Protocol (MCP) server (@temphonenumber/mcp-server at https://www.temphonenumber.com/api/mcp) connects AI coding agents in Cursor, Claude Desktop, and Windsurf directly to physical Tier-1 non-VoIP SIM inventory across 150+ countries. Using 7 standardized JSON-RPC 2.0 tools—get_balance, list_services, list_countries, order_number, check_messages, flag_number, and get_active_orders—agents autonomously lease numbers from $0.11 and retrieve 6-digit SMS OTP codes in under 8 seconds.
النقاط الرئيسية
- The temphonenumber MCP server implements the 2025-03-26 Streamable HTTP JSON-RPC 2.0 specification at https://www.temphonenumber.com/api/mcp.
- Exposes 7 canonical tools: get_balance, list_services, list_countries, order_number, check_messages, flag_number, and get_active_orders.
- Allows autonomous QA agents in Cursor, Claude Desktop, and Windsurf to complete SMS 2FA flows across 3,000+ services starting at $0.11.
What Is the temphonenumber MCP Server and How Does It Work?
The temphonenumber Model Context Protocol (MCP) server is a standardized JSON-RPC 2.0 interface that bridges Large Language Models (LLMs) and autonomous coding agents with physical Tier-1 cellular SIM hardware across more than 150 countries and 3,000 supported online services. Instead of writing custom REST polling loops or manually copying verification codes from a mobile handset during end-to-end Playwright testing, developers configure @temphonenumber/mcp-server or connect directly to https://www.temphonenumber.com/api/mcp using Streamable HTTP transport. Once authenticated with x-client-id and x-client-secret headers, AI assistants such as Claude Desktop, Cursor Composer, and Windsurf Cascade can invoke seven deterministic tools: get_balance, list_services, list_countries, order_number, check_messages, flag_number, and get_active_orders. Incoming SMS OTP messages are routed over SS7 carrier interconnects in under 8 seconds, with automatic 100% balance refunds if no verification text arrives within the rental window.
The 7 Canonical MCP Tools for Autonomous Telephony
- •1. get_balance — Inspect current USD wallet credit balance and account tier before provisioning.
- •2. list_services — Query supported applications (3,000+ services) and per-verification pricing starting at $0.11.
- •3. list_countries — List 150+ available ISO country codes, dialing prefixes, and real-time physical SIM stock.
- •4. order_number — Allocate a private single-tenant non-VoIP E.164 phone number for a target country and service.
- •5. check_messages — Poll incoming SMS messages and extract the 6-digit OTP verification code.
- •6. flag_number — Cancel an unresponsive number and trigger an immediate automatic wallet refund.
- •7. get_active_orders — View all currently active number rentals and remaining session expiration timers.
Which MCP tools are exposed by the temphonenumber server?
Which MCP tools are exposed by the temphonenumber server?
The server exposes 7 canonical tools: get_balance, list_services, list_countries, order_number, check_messages, flag_number, and get_active_orders.
How do I connect Cursor or Claude Desktop to the MCP server?
How do I connect Cursor or Claude Desktop to the MCP server?
Run npx -y @temphonenumber/mcp-server or configure Streamable HTTP transport pointing to https://www.temphonenumber.com/api/mcp with your x-client-id and x-client-secret headers.
Key Benchmarks & Data Points
- 7 canonical MCP tools exposed over Streamable HTTP JSON-RPC 2.0 (2025-03-26 spec)—temphonenumber MCP Server Specification
- Sub-8-second median SMS OTP extraction latency across 150+ countries—temphonenumber Telemetry Benchmark 2026