Phone Carrier Detector MCP Server

The Phone Carrier Detector MCP server provides a lightweight, high‑performance solution for identifying the mobile network operator and geographic origin of Chinese phone numbers. It solves a common pain point in many AI‑driven workflows: the need to enrich raw phone data with carrier and location metadata without resorting to external paid APIs or maintaining large local databases. By exposing a simple JSON‑RPC interface, the server lets AI assistants like Claude instantly look up carrier information, supporting both single and bulk queries.

At its core, the server loads a pre‑parsed 492,088‑record memory database that maps every known Chinese mobile prefix to its operator (China Mobile, China Unicom, China Telecom, as well as virtual carriers such as China Broadcasting and China Iron & Steel). The in‑memory hash table guarantees O(1) lookup time, enabling sub‑millisecond responses even under heavy concurrent load. For developers integrating AI assistants into customer‑support or fraud‑prevention pipelines, this means that every phone number can be annotated with carrier and city information in real time, improving data quality and user experience.

Key capabilities include:

• Single‑number detection () that returns carrier, province, city, and prefix.
• Batch detection () for up to 100 numbers per request, returning a compact list of results.
• Virtual carrier support so that virtual number services are correctly identified.
• High‑precision, city‑level location data sourced from an up‑to‑date database.
• Asynchronous, concurrent handling to keep latency low in multi‑tenant AI environments.

Typical use cases span several industries:

• Customer‑support automation: An AI agent can verify the customer’s phone number, determine if it belongs to a supported carrier, and pre‑populate location fields in support tickets.
• Fraud detection: By quickly correlating a caller’s number with its geographic origin, AI models can flag suspicious patterns such as cross‑border calls from virtual numbers.
• Marketing segmentation: Campaign engines can segment audiences by carrier or region, tailoring offers to local preferences.
• Telecom analytics: Internal tools can ingest call logs and enrich them with carrier metadata for reporting.

Integration is straightforward: once the MCP server is registered in an AI client (e.g., Claude Desktop), developers can invoke the tools with natural language prompts like “请帮我检测手机号码 13812345678 的运营商和归属地信息”. The server responds with structured JSON, which the assistant can parse and present to users or feed into downstream pipelines. Because the server is written in pure Python 3.8+ and relies only on standard libraries, it can be deployed locally or in cloud functions without external dependencies.

In summary, the Phone Carrier Detector MCP server delivers fast, accurate carrier and location lookup for Chinese phone numbers, empowering AI assistants to enrich data on the fly while keeping infrastructure simple and cost‑effective.