# MCC-MNC.dev

> Free, searchable registry of 3,042 mobile networks in 227 countries — mobile country codes (MCC), mobile network codes (MNC), PLMN identifiers, ISO country codes, dial prefixes and operators — with a free JSON API and phone-number-to-operator lookup.

MCC-MNC.dev maps every PLMN (an MCC + MNC pair, the identifier a SIM broadcasts) to its country, operator, brand, status and radio bands, with extra operator-level detail (subscribers, market reach, ownership, rank, technology) for the ~200 European networks. Everything is queryable through a free REST API (one API key, no cost) and downloadable in bulk as JSON or CSV. Ideal for phone-number network detection, telecom data enrichment, and RAG over a clean, licensed telecom dataset. Data is licensed CC BY-SA 4.0.

## Docs
- [What is MCC / MNC / PLMN](https://mcc-mnc.dev/what-is-mcc-mnc): plain-language explainer of the codes and how they relate to IMSI and dial prefixes.
- [API documentation](https://mcc-mnc.dev/docs): endpoints, authentication, response fields, output formats and official client libraries.
- [About the data](https://mcc-mnc.dev/about-data): sources, licensing, update cadence and honest caveats.
- [For AI & LLMs](https://mcc-mnc.dev/ai): ready-to-paste tool/function schemas, agent examples, RAG guidance, and MCP-server install steps for Claude Code and Codex.

## MCP server
- POST https://mcc-mnc.dev/mcp : hosted Model Context Protocol server (Streamable HTTP, JSON-RPC), no key. Tools: mcc_mnc_lookup (by plmn, or mcc+mnc, or mcc) and mcc_mnc_search (text, ISO code, operator, or phone number). Add to Claude Code: `claude mcp add --transport http mcc-mnc https://mcc-mnc.dev/mcp`.

## API
Base URL: https://mcc-mnc.dev/api/v1 — every endpoint is GET, a free API key is required, sent as `X-API-Key: mcc_...` (alias `Authorization: Bearer mcc_...`). CORS is open. Rate limit 100 req/s per key.
- GET /api/v1/search?q=... : one search box for everything — MCC, PLMN, country name/ISO, operator/brand, or a phone number (returns a phone analysis plus the matched country's operators).
- GET /api/v1/plmn/{plmn} : exact lookup by concatenated PLMN, e.g. /plmn/23002. Returns one flat Row.
- GET /api/v1/mcc/{mcc} : all networks registered under one mobile country code, e.g. /mcc/230.
- GET /api/v1/mcc/{mcc}/{mnc} : a single network by MCC + MNC, e.g. /mcc/230/02.
- GET /api/v1/dataset : the full dump as json (default), csv or text. Supports a fields subset.

## Data
- [networks.json](https://mcc-mnc.dev/data/networks.json): full nested dataset, no API key required.
- [networks.csv](https://mcc-mnc.dev/data/networks.csv): flat CSV, the same columns as the API wire format.
- [meta.json](https://mcc-mnc.dev/data/meta.json): generation metadata (timestamp, counts, license) for detecting new revisions.
- License: CC BY-SA 4.0. Attribution: "Data: MCC-MNC.dev (https://mcc-mnc.dev), derived from Wikipedia — CC BY-SA 4.0".

## Optional
- [Full knowledge doc](https://mcc-mnc.dev/llms-full.txt): a single, dense, copy-pasteable reference (concepts + complete API reference).
- [United States networks](https://mcc-mnc.dev/country/united-states)
- [United Kingdom networks](https://mcc-mnc.dev/country/united-kingdom)
- [Germany networks](https://mcc-mnc.dev/country/germany)
- [Czech Republic networks](https://mcc-mnc.dev/country/czech-republic)