World Geographic Data for AI Agents
Give your AI agent real-time access to structured geographic data. 261 countries. 13.4 million cities. 20+ statistics per country. One command to install.
npx bamwor-mcp-serverWhat is MCP?
The Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude, GPT, and others to call external tools directly. Instead of the AI guessing or hallucinating data, it queries real APIs and returns verified facts.
Why Bamwor for AI?
| Source | Cities | Countries | MCP | API |
|---|---|---|---|---|
| REST Countries | 0 | 250 | No | Free |
| CountryStateCity | 151K | 250 | No | No |
| API Ninjas | 5M | — | No | Paid |
| Bamwor | 13.4M | 261 | Yes | Free + Paid |
Access all 16 ranking metrics including 9 proprietary Bamwor indices directly from your AI agent via the get_rankings tool. With the Premium plan, the REST API also provides narrative country profiles — government structure, economy overview, demographics, military, and more — enabling agents to answer qualitative questions about any country.
Available Tools
get_countryGet detailed data about a country including population, area, GDP, HDI, life expectancy, and 20+ statistics.
{ query: "Brazil" }search_countriesSearch countries by name or keyword. Returns matching countries with region and population.
{ query: "south", limit: 10 }search_citiesSearch cities worldwide from a database of 13.4M cities. Returns name, population, country, and coordinates.
{ query: "Springfield", limit: 10 }list_cities_by_countryList cities in a country sorted by population or name. Filter by minimum population.
{ country: "germany", min_population: 500000 }compare_countriesCompare two countries side by side across all metrics: population, area, GDP, HDI, and more.
{ country_a: "France", country_b: "Germany" }get_rankingsGet country rankings by any metric. 16 metrics available: population, area, density, gdp, gdp-per-capita, hdi, life-expectancy, and 9 Bamwor proprietary indices (IBEU, IBCP, IBDA, IBCX, IBEE, IBFM, IBDI, IBED, IBSA). Omit metric to list all.
{ metric: "population", limit: 10, countries_only: true }get_cityGet detailed information about a specific city by its GeoNames ID. Returns coordinates, population, elevation, timezone, and province.
{ city_id: 1850147 }get_nearby_citiesFind cities near a specific city using PostGIS radius search. Returns nearby cities with distance in km.
{ city_id: 1850147, radius: 50, limit: 10 }Installation
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"bamwor-world-data": {
"command": "npx",
"args": ["-y", "bamwor-mcp-server"],
"env": {
"BAMWOR_API_KEY": "bw_live_your_key_here"
}
}
}
}Cursor / Windsurf
{
"bamwor-world-data": {
"command": "npx",
"args": ["-y", "bamwor-mcp-server"],
"env": {
"BAMWOR_API_KEY": "bw_live_your_key_here"
}
}
}What you can ask your AI
FAQ
Do I need an API key?▼
Which AI clients are supported?▼
Is the data real-time?▼
What languages are supported?▼
Is there a rate limit?▼
Is this open source?▼
Open Datasets
Download curated subsets of the Bamwor database for offline analysis and model training:
World Countries 2026
261 countries — population, area, region, coordinates, ISO codes
Ready to start?
Get a free API key and connect your AI agent in under 5 minutes.
Find Bamwor on MCP Directories
Bamwor MCP Server is listed on the most popular MCP directories:
- ✓PulseMCP — Featured server for world geographic data
- ✓mcp.so — MCP server registry
- ✓mcphub.io — MCP Hub directory
- ✓mcp-get.com — Install and manage MCP servers
- ✓npm — bamwor-mcp-server v0.2.2
Can't find us on your favorite directory? Let us know.