Model Context Protocol
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.
What 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_country
Get detailed data about a country including population, area, GDP, HDI, life expectancy, and 20+ statistics.
{ query: "Brazil" }search_countries
Search countries by name or keyword. Returns matching countries with region and population.
{ query: "south", limit: 10 }search_cities
Search cities worldwide from a database of 13.4M cities. Returns name, population, country, and coordinates.
{ query: "Springfield", limit: 10 }list_cities_by_country
List cities in a country sorted by population or name. Filter by minimum population.
{ country: "germany", min_population: 500000 }compare_countries
Compare two countries side by side across all metrics: population, area, GDP, HDI, and more.
{ country_a: "France", country_b: "Germany" }get_rankings
Get 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_city
Get detailed information about a specific city by its GeoNames ID. Returns coordinates, population, elevation, timezone, and province.
{ city_id: 1850147 }get_nearby_cities
Find 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:
Cursor / Windsurf
What you can ask your AI
"What is the population of Nigeria?"
"List the 10 largest cities in India"
"Compare Japan and South Korea"
"Search for cities named Springfield"
"Which countries are in Central Africa?"
"What is the GDP of Brazil vs Argentina?"
FAQ
Do I need an API key?▼
Yes. Register for a free API key at bamwor.com/developers/quickstart. The free plan includes 1,000 requests/day.
Which AI clients are supported?▼
Any MCP-compatible client: Claude Desktop, Cursor, Windsurf, Continue, Cline, and others. The server uses the stdio transport standard.
Is the data real-time?▼
The MCP server queries the Bamwor REST API on every request. Data is sourced from CIA World Factbook, UN, World Bank, and GeoNames.
What languages are supported?▼
Country and city names are available in English, Spanish, Portuguese, and Italian.
Is there a rate limit?▼
Free: 30 req/min, 1,000/day. Pro: 60 req/min, 10,000/day. Premium: 300 req/min, 50,000/day. Enterprise: 600 req/min, 500,000/day.
Is this open source?▼
Yes. The MCP server is MIT licensed. The underlying data is provided by the Bamwor API.
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
World Cities 2026
5,979 cities — population, coordinates, timezone, elevation
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.