World Countries — ISO 3166 Codes, Capitals, Regions, Area, Currencies, Languages, Borders
Every country and territory in ISO 3166 (250 rows) with alpha-2, alpha-3 and numeric codes, common and official names, capitals, UN region and sub-region, land area, independence and UN-membership flags, currencies, languages, centroid coordinates, landlocked flag, land borders, top-level domain and calling code. Built from the mledoze/countries compilation on 2026-09-05. The reference table every other dataset joins to; pair with the World Population set for headcounts. Read with pandas.read_csv(path, compression='gzip').
Use Cases
- Join key for any country-level dataset
- Region and sub-region grouping
- Currency and language lookups
- Map centroids and neighbour graphs
Methodology
Single fetch of countries.json; one row per ISO 3166 entity, sorted by common name.
Update Schedule
Static snapshot. Country data changes a few times a year; refresh quarterly.
Attribution
Source: mledoze/countries (github.com/mledoze/countries), Open Database License (ODbL).
Schema
| name | type |
|---|---|
| alpha_2 | string |
| alpha_3 | string |
| numeric | integer |
| name | string |
| official_name | string |
| capital | string |
| region | string |
| sub_region | string |
| area_km2 | number |
| independent | boolean |
| un_member | boolean |
| status | string |
| currencies | string |
| languages | string |
| latitude | number |
| longitude | number |
| landlocked | boolean |
| borders | string |
| tld | string |
| calling_code | string |
Sample Data
| tld | name | region | status | alpha_2 | alpha_3 | borders | capital | numeric | area_km2 | latitude | languages | longitude | un_member | currencies | landlocked | sub_region | independent | calling_code | official_name |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| .af | Afghanistan | Asia | officially-assigned | AF | AFG | IRN;PAK;TKM;UZB;TJK;CHN | Kabul | 004 | 652230 | 33 | Dari;Pashto;Turkmen | 65 | true | AFN | true | Southern Asia | true | +93 | Islamic Republic of Afghanistan |
| .ax | Åland Islands | Europe | officially-assigned | AX | ALA | Mariehamn | 248 | 1580 | 60.116667 | Swedish | 19.9 | false | EUR | false | Northern Europe | false | +35818 | Åland Islands | |
| .al | Albania | Europe | officially-assigned | AL | ALB | MNE;GRC;MKD;UNK | Tirana | 008 | 28748 | 41 | Albanian | 20 | true | ALL | false | Southeast Europe | true | +355 | Republic of Albania |
| .dz;الجزائر. | Algeria | Africa | officially-assigned | DZ | DZA | TUN;LBY;NER;ESH;MRT;MLI;MAR | Algiers | 012 | 2381741 | 28 | Arabic | 3 | true | DZD | false | Northern Africa | true | +213 | People's Democratic Republic of Algeria |
| .as | American Samoa | Oceania | officially-assigned | AS | ASM | Pago Pago | 016 | 199 | -14.33333333 | English;Samoan | -170 | false | USD | false | Polynesia | false | +1684 | American Samoa |
Get this via API
# 1. Add dAgentBase once, in any MCP client. No install, no vendor keys.
# Claude.ai / Claude Desktop: Settings -> Connectors -> Add custom connector
# Cursor / Claude Code / others: mcp.json
{
"mcpServers": {
"dagentbase": {
"url": "https://dagentbase.com/api/mcp",
"headers": { "Authorization": "Bearer dm_live_YOUR_KEY" }
}
}
}
# 2. Then ask your agent, in plain language:
# "Preview 'World Countries — ISO 3166 Codes, Capitals, Regions, Area, Currencies, Languages, Borders' and, if it fits, claim it and download the files."
# Tools it will use: search_listings -> preview_listing -> purchase_listing -> get_download_urls
# 1. Add dAgentBase once, in any MCP client. No install, no vendor keys.
# Claude.ai / Claude Desktop: Settings -> Connectors -> Add custom connector
# Cursor / Claude Code / others: mcp.json
{
"mcpServers": {
"dagentbase": {
"url": "https://dagentbase.com/api/mcp",
"headers": { "Authorization": "Bearer dm_live_YOUR_KEY" }
}
}
}
# 2. Then ask your agent, in plain language:
# "Preview 'World Countries — ISO 3166 Codes, Capitals, Regions, Area, Currencies, Languages, Borders' and, if it fits, claim it and download the files."
# Tools it will use: search_listings -> preview_listing -> purchase_listing -> get_download_urlsone time · open license
Details
Available formats