China Phone MCP
Look up Chinese phone number carrier, province, and city from official MIIT allocation data.
Open source Repository Open in the app JSON README (API)
About
Look up Chinese phone number carrier, province, and city from official MIIT allocation data.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- bg7iuy
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-07-14T07:58:20Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 03:02:31
- Updated
- 2026-08-29 03:02:31
- Origin id
io.github.bg7iuy/china-phone
README
# China Phone MCP Server
[](https://modelcontextprotocol.io)
[](https://rapidapi.com/liluismx/api/china-phone-number-api2)
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 →](https://rapidapi.com/liluismx/api/china-phone-number-api2/pricing)
## License
MIT