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.

Install with one command
npx bamwor-mcp-server
Get free API keynpmGitHub
261
Countries
13.4M
Cities
20+
Stats/country
4
Languages

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?

SourceCitiesCountriesMCPAPI
REST Countries0250NoFree
CountryStateCity151K250NoNo
API Ninjas5M—NoPaid
Bamwor13.4M261YesFree + Paid

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" }

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

"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: 120 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

HuggingFaceKaggle

World Cities 2026

5,979 cities — population, coordinates, timezone, elevation

HuggingFaceKaggle

Ready to start?

Get a free API key and connect your AI agent in under 5 minutes.

Get free API keyView on npm