>mcc-mnc.org
Account and API keys

Data · MCP server

The MCC-MNC database, inside your AI assistant

Add one URL to Claude, ChatGPT, Cursor or VS Code and your assistant can identify any MCC, MNC, PLMN or TADIG code, list a country's operators, or find who runs 5G where. It answers from the live database and links to every record.

Server URL

https://mcc-mnc.org/api/mcp

FreeNo API keyRead-only10 tools

Set up in

ClaudeChatGPT>_Claude CodeCursorVS CodeWindsurf>_Gemini CLI>_Codex
AI assistantmcc-mnc · 10 tools
My roaming log shows 23415, 26202 and 21401. Who are they?
Calledlookup_plmn× 3

All three are Vodafone, one in each country:

Vodafone UKPLMN 234 15 · 5G · LTETADIGGBRVFVodafone D2 GmbHPLMN 262 02 · 5G · LTETADIGDEUD2Vodafone SpainPLMN 214 01 · 5G · LTETADIGESPAT
Real answer from this serverAll TADIG codes
>mcc-mnc connected

Connect it in under a minute

Pick your client. There's nothing to install and nothing to sign up for. The URL is the whole configuration.

Add it to Claude

On claude.ai or the desktop app, open Settings → Connectors, choose Add custom connector and paste the URL. Leave the OAuth fields empty, then switch it on from the tools menu in any chat. It syncs to the mobile apps too.

Settings → Connectors → Add custom connector
https://mcc-mnc.org/api/mcp

Or let your agent set it up

Coding agents like Claude Code, Cursor and Codex can edit their own MCP config. Paste this in and it will add the server and tell you what it can do.

Add the mcc-mnc.org MCP server to your configuration. It's a Streamable HTTP server at https://mcc-mnc.org/api/mcp and needs no authentication. It has 10 read-only tools: lookup_plmn, search_networks, get_country, search_tadigs, list_countries, list_network_types, get_network_services, lookup_cell, search_mvnos, get_stats. Once it's added, tell me what you can now look up, then ask me which network code I'm trying to identify.

Ask it like a network engineer

Once it's connected, paste one of these into your assistant. Each card shows the exact tool call it turns into.

You ask

My modem log says it's registered on 310-260. Which network is that?

It runs

lookup_plmnmcc 310 · mnc 260

You ask

Which operators run 5G in Italy, and what are their MNCs?

It runs

search_networkscountry IT · generation 5G

You ask

I need the TADIG codes for every Vodafone network.

It runs

search_tadigsquery vodafone

You ask

Which country uses MCC 505, and who operates there?

It runs

get_countrycountry 505

What the assistant can do

10 read-only tools over the same data behind every page on this site. Every result links back to its record.

lookup_plmn

Look up a PLMN

Identify the mobile network behind an MCC/MNC pair or a PLMN ID (MCC+MNC concatenated, e.g. 23410). Returns the operator, brand, country, TADIG code and radio technologies, how many cell towers have been measured on it (per technology, from OpenCelliD), plus any other networks sharing the same code. Use this whenever the user has numeric network codes — from an IMSI, a SIM, a modem log or a roaming record.

plmn
PLMN ID — the MCC followed by the MNC, 5 or 6 digits (e.g. 23410).
mcc
Mobile country code, 3 digits (e.g. 262). Use together with mnc.
mnc
Mobile network code, 2 or 3 digits with leading zeros kept (e.g. 01). Use together with mcc.
example call · arguments
{
  "mcc": "262",
  "mnc": "01"
}
search_networks

Search networks

Find mobile networks by free-text search (operator, brand, TADIG, PLMN or country name) and/or structured filters: country, region, MCC, radio technology or generation. All filters combine with AND. Use it for questions like 'which operators run 5G in Germany' or 'what is Vodafone's code in Spain'.

query
Free-text search across operator, brand, TADIG, slug, MCC, MNC, PLMN and country name.
country
ISO 3166 alpha-2 code (e.g. DE) or country slug (e.g. germany).
region
Region name or slug (e.g. europe). Call list_countries for the regions in use.
mcc
Exact mobile country code, e.g. 310.
generation
Only networks running this generation of radio technology.
technology
Network type name or slug, e.g. LTE, NR, GSM. See list_network_types.
limit
Maximum number of results (1–50, default 20).
example call · arguments
{
  "country": "DE",
  "generation": "5G",
  "limit": 5
}
get_country

Get a country

One country with every mobile network registered in it: operator, brand, MCC/MNC, PLMN, TADIG, technologies and measured cell towers. Accepts an ISO code, a slug, a country name, or an MCC (to answer 'which country is MCC 234?').

country*
ISO 3166 alpha-2 code (GB), slug (united-kingdom), name (United Kingdom) or a 3-digit MCC (234).
example call · arguments
{
  "country": "GB"
}
search_tadigs

Search TADIG codes

Look up TADIG codes — the five-character GSMA identifiers (e.g. GBRCN) used in roaming agreements, TAP files and billing. Pass tadig for an exact code, or query/country to list them.

tadig
Exact TADIG code, case-insensitive (e.g. DEUD1).
query
Partial TADIG, operator, brand or country name.
country
ISO 3166 alpha-2 code or country slug.
limit
Maximum number of results (1–50, default 20).
example call · arguments
{
  "country": "BR",
  "limit": 5
}
list_countries

List countries

Countries and territories with their ISO code, dial code, region and network count. Filter by region or a partial name; sorted by name.

query
Partial country name, slug, ISO code or dial code.
region
Region name or slug, e.g. europe.
limit
Maximum number of results (1–300, default 50).
example call · arguments
{
  "region": "oceania"
}
list_network_types

List network types

The radio technologies and bands tracked in the database (GSM, UMTS, LTE, NR and their frequencies), each with its generation and how many networks run it.

generation
Only technologies belonging to this generation.
example call · arguments
{
  "generation": "5G"
}
get_network_services

Network services & APNs

What a mobile network offers beyond its codes: whether it supports VoLTE, VoWiFi (Wi-Fi calling), ViLTE (video calling) and VoNR, its APN settings, and the MVNOs and travel/IoT SIM brands running on it (with their APNs). Use it for questions like 'what are the APN settings for O2 UK', 'does Vodafone Spain support VoLTE' or 'which MVNOs use T-Mobile US'. Pass the codes as for lookup_plmn — call search_networks first if you only have a name. States are YES, LIKELY (inferred, e.g. from an IMS APN) or NO; unknown means we have no data, not that it's unsupported.

plmn
PLMN ID — the MCC followed by the MNC, 5 or 6 digits (e.g. 23410).
mcc
Mobile country code, 3 digits (e.g. 234). Use together with mnc.
mnc
Mobile network code, 2 or 3 digits with leading zeros kept (e.g. 10). Use together with mcc.
example call · arguments
{
  "plmn": "23410"
}
lookup_cell

Look up a cell tower

Locate a mobile cell tower from its identity — MCC, MNC and cell ID, as a phone, modem log or network scanner reports them (Cell ID/CID, or the 28-bit ECI on LTE, 36-bit NCI on 5G). Returns the measured position (lat/lon), estimated range, radio technology, area code (LAC/TAC), how many measurements it's based on and when it was first and last seen, plus the network it belongs to. Positions come from OpenCelliD's crowd-sourced measurements, so they're approximate, and no match only means nobody has measured that cell yet. Several matches mean the same ID was seen under different areas or radios: pass area or radio to narrow it. Each call counts as one request against the mcc-mnc.org weekly API allowance (100 a week without a key; send an API key as Authorization: Bearer … for more).

mcc*
Mobile country code, e.g. 234.
mnc*
Mobile network code, e.g. 10. Leading zeros don't matter here.
cell*
Cell ID in decimal, or hex with a 0x prefix (e.g. 2192494 or 0x21746E). For LTE this is the full ECI (eNodeB ID × 256 + sector).
area
Optional LAC (2G/3G) or TAC (4G/5G), decimal or 0x hex.
radio
Optional radio technology.
example call · arguments
{
  "mcc": "234",
  "mnc": "10",
  "cell": "2192494"
}
search_mvnos

Search MVNOs

Find MVNOs — virtual operators and brands that run on someone else's network, like giffgaff or Lycamobile — by name, country, host network or category. Returns each brand's countries and the networks currently hosting it. Use it for 'which network does giffgaff use' or 'list the travel eSIM brands on Vodafone NL'; then get_network_services on a host network gives its APNs and VoLTE support.

query
Partial brand name, case-insensitive.
country
ISO 3166 alpha-2 code (e.g. GB) or country slug — brands trading in that country.
network
PLMN ID of a host network (e.g. 23410) — brands currently running on it.
category
What the brand sells.
limit
Maximum number of results (1–50, default 20).
example call · arguments
{
  "country": "GB",
  "query": "lyca"
}
get_stats

Database stats

Headline counts for the database — networks, countries, regions, network types, networks with a TADIG, measured cell towers — and when it was last updated.

Takes no arguments.

example call · arguments
{}

Try it live

Runs a real tool call against the production database and shows exactly what an assistant receives.

POST /api/mcp · tools/callproduction

Tool

Identify the mobile network behind an MCC/MNC pair or a PLMN ID (MCC+MNC concatenated, e.g. 23410). Returns the operator, brand, country, TADIG code and radio technologies, how many cell towers have been measured on it (per technology, from OpenCelliD), plus any other networks sharing the same code. Use this whenever the user has numeric network codes — from an IMSI, a SIM, a modem log or a roaming record.

⌘/Ctrl + Enter

What the assistant receives

Run a tool to see the result

Network codes, MCP and your AI assistant

New to either idea? Here's what the codes are, what an MCP server does, and how the two turn a pasted log line into an answer you can check.

What is an MCC-MNC?

Every mobile network is identified by a mobile country code plus a mobile network code. Together they make the PLMN ID in every IMSI, modem log and roaming record. Roaming partners also swap five-character TADIG codes. This site tracks all of them for 2,600+ networks.

What is an MCP server?

MCP (the Model Context Protocol) is an open standard that lets assistants like Claude, ChatGPT and Cursor call outside tools. An MCP server is the thing they call. Instead of answering from training data, which misses reassigned codes and invents plausible ones, the assistant looks the code up here.

How it works

  1. 1

    You ask about a code

    Paste an IMSI prefix, a PLMN from a log, or just a question.

    Which network is 310-260 on my modem log?

  2. 2

    Your assistant calls a tool

    It picks the tool, fills in the arguments and queries the live database.

    >lookup_plmn
  3. 3

    You get an answer you can check

    Operator, country, TADIG and technologies, with a link to the record.

    T-Mobile USAPLMN 310 260 · 5G · LTETADIGUSAW6

Answers you can check

Every record comes back with its mcc-mnc.org URL, and the server tells the assistant to cite it. If something looks wrong, you're one click from the source, and from submitting a fix.

No key, no sign-up

The server is public, read-only and unmetered: just be reasonable. Writing code instead? The REST API serves the same data over plain HTTP.

MCP server FAQ

The questions telecom engineers and developers ask before connecting it.

Still have a question?

Need bulk access, found a wrong code, or want a tool we don't have yet? We read every message.

Contact us
Is it free?

Yes. There's no API key, no account and no usage fee, and it's free for commercial use. We just ask that you don't loop over the whole dataset. If you want everything, the bulk downloads give you every network in one file. The one exception is cell tower lookups (lookup_cell), which share the API's weekly allowance: 100 a week without a key, or 10,000 if you create one and send it as Authorization: Bearer <key>.

Which AI assistants can use it?

Any client that supports remote MCP servers over Streamable HTTP. That includes Claude (web, desktop and Claude Code), ChatGPT in developer mode, Cursor, VS Code with Copilot, Windsurf, Gemini CLI and Codex. Clients that only launch local servers can connect through the mcp-remote bridge.

Why not just ask the assistant? It already knows MCCs.

It knows the famous ones. MNCs get reassigned, operators merge and rebrand, and a model's training data is months or years old. Language models are also very good at inventing a plausible-looking MNC or TADIG. With the server connected, the answer comes from a record you can open.

Can the assistant change the database?

No. All 10 tools are read-only lookups, and each one is marked readOnlyHint so clients can run it without asking you first. If you spot a mistake, submit a correction on the site. A person reviews it before it goes live.

How current is the data?

It's the same data the site shows. MCP calls query the database directly, so an approved correction shows up in the next tool call. Recent changes are listed on the changelog.

What does it cover?

Every network in the database: MCC, MNC, PLMN ID, operator and brand, country and region, the TADIG code where one is known, and the radio technologies (GSM, UMTS, LTE, 5G NR and their bands). TADIG coverage is partial, and we're filling it in over time.

Is it the same as the REST API?

Underneath, yes: the tools run the same queries as /api/v1, so a filter means the same thing in both. The difference is packaging. The MCP server is shaped for a model, with trimmed records and error messages the model can act on. Use the API when you're writing code yourself.

Is there a rate limit?

There's no hard limit on the MCP server today, just a fair-use expectation. (The REST API, by contrast, has a weekly allowance per key or IP.) If you're planning heavy automated use, get in touch.

Prefer to look it up yourself?

Everything the server returns is on the site too, searchable by code, operator, country and technology. Or take the whole dataset as a file.

Browse networks Bulk downloads