>mcc-mnc.org

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-only7 tools

Set up in

ClaudeChatGPT>_Claude CodeCursorVS CodeWindsurf>_Gemini CLI>_Codex
AI assistantmcc-mnc · 7 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 7 read-only tools: lookup_plmn, search_networks, get_country, search_tadigs, list_countries, list_network_types, 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

7 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, 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 and technologies. 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_stats

Database stats

Headline counts for the database — networks, countries, regions, network types, networks with a TADIG — 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, 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 and read-only, with the same fair-use expectations as the REST API. If you need heavy automated access, get in touch.

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.

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 seven 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 today, just the same fair-use expectation as the API. 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