About China Phone MCP
China Phone MCP looks up carrier and geographic details for Chinese phone numbers using public MIIT allocation data. It is intended for AI agents and reports number type and prefix validity without accessing carrier networks or collecting personal data.
Key features
- 01Identify carrier from a phone number
- 02Return province, city, and area codes
- 03Report number type and prefix validity
- 04Use public MIIT allocation tables
Use cases
- 01Check the carrier for a Chinese phone number
- 02Determine a number's province and city
- 03Validate a phone prefix against allocation data
MCP support
The MCP server exposes phone-number lookup tools that return carrier, geographic, number-type, and prefix-validity information.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://china-phone-mcp.vercel.app/api/indexclaude mcp add --transport http bg7iuy-china-phone https://china-phone-mcp.vercel.app/api/index{"mcpServers":{"bg7iuy-china-phone":{"type":"http","url":"https://china-phone-mcp.vercel.app/api/index"}}}Open in Cursor{"servers":{"bg7iuy-china-phone":{"type":"http","url":"https://china-phone-mcp.vercel.app/api/index"}}}Open in VS Code{"mcpServers":{"bg7iuy-china-phone":{"type":"http","url":"https://china-phone-mcp.vercel.app/api/index"}}}{"mcpServers":{"bg7iuy-china-phone":{"serverUrl":"https://china-phone-mcp.vercel.app/api/index"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
2| Parameter | Type | Required | Description |
|---|---|---|---|
| phone | string | Yes | 11-digit Chinese phone number |
Details
From the project READMEChina 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
claude mcp add china-phone https://china-phone-mcp.vercel.app/api/index
Use with Cursor
Add to your Cursor MCP config:
{
"mcpServers": {
"china-phone": {
"url": "https://china-phone-mcp.vercel.app/api/index"
}
}
}
Run locally
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.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.