A Model Context Protocol (MCP) server that enables AI agents to look up Chinese phone number carrier and location information from official MIIT allocation data.

🛠️ Key Features

Looks up 11-digit Chinese mobile numbers
Returns carrier (China Mobile, China Unicom, China Telecom, China Broadnet)
Provides location data: province and city (including area when available)
MCP-compliant server suitable for AI agents

🚀 Use Cases

AI assistants resolving caller identity and routing by carrier
Location-aware response generation for customer support
Data enrichment for analytics and logs involving Chinese phone numbers

⚡ Developer Benefits

Lightweight MCP server with two tools
Grounded in official MIIT allocation data
Clear readme excerpt and deployment-ready structure

⚠️ Limitations

Data coverage limited to official MIIT allocations; may not include every number
Locale specifics may vary by region and data refresh cycles

China Phone MCP Server

A Model Context Protocol (MCP) server that enables AI agents (Claude Code, Cursor, Windsurf) to look up Chinese phone number carrier and location information.

What it does

Given an 11-digit Chinese mobile number, returns:

Carrier: China Mobile / China Unicom / China Telecom / China Broadnet
Location: Province, city, area code, postal code, region code
Number type: Mobile or landline
Prefix validity: Based on MIIT official allocation tables

Tools

Tool	Description
`lookup_china_phone`	Full attribution lookup with all fields
`get_china_phone_info`	Detailed carrier + geographic info

Data Source

Official MIIT (Ministry of Industry and Information Technology) public number allocation tables, updated monthly. No carrier networks accessed. No personal data collected.

Quick Start

Install in Claude Code

bash

claude mcp add china-phone https://china-phone-mcp.vercel.app/api/index

Use with Cursor

Add to your Cursor MCP config:

json

{
  "mcpServers": {
    "china-phone": {
      "url": "https://china-phone-mcp.vercel.app/api/index"
    }
  }
}

Run locally

bash

pip install -r requirements.txt
export RAPIDAPI_KEY=your_key_here
python server.py

Deployment

Deploy to Vercel with one click, or run on any Python host.

Set the environment variable RAPIDAPI_KEY in your deployment.

Pricing

The underlying API has a free tier (1,000 requests/day). Paid plans start at $14.99/month for 100,000 requests/month.

Get your RapidAPI key →

License

MIT