mcpField
B
Bamwor World Data

Bamwor World Data

Local
github.com/bamwor-devData & Analytics2Updated 21w ago
Repository

About Bamwor World Data

Bamwor World Data is an MCP server for AI agents that provides geographic data on countries and cities. Its tools cover country statistics, city searches, comparisons, rankings, and nine Bamwor indices.

Key features

  1. 01Retrieve detailed country statistics
  2. 02Search countries and cities
  3. 03Filter cities by country
  4. 04Compare country metrics
  5. 05Get rankings by metric
  6. 06Look up cities and nearby places

Use cases

  1. 01Find a country's population, area, and capital
  2. 02Compare statistics for two countries
  3. 03Filter for large cities in a country
  4. 04Find cities near a specified city

MCP support

The MCP server exposes eight tools for querying country and city data to compatible clients. The README names Claude Desktop, Cursor, and Windsurf as supported clients.

#geography#countries#cities#world-data#geospatial#ai-tools

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "bamwor": {
      "command": "npx",
      "args": [
        "-y",
        "bamwor-mcp-server"
      ],
      "env": {
        "BAMWOR_API_KEY": "<BAMWOR_API_KEY>"
      }
    }
  }
}
Run commandnpx -y bamwor-mcp-server
Environment variables to set
BAMWOR_API_KEYSecretOptional. Bamwor API key for full access and higher rate limits. Works anonymously without it. Get one free at https://bamwor.com/en/developers/quickstart

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmbamwor-mcp-server0.2.2

Tools

8

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
querystringYesCountry name (e.g. "Brazil"), slug (e.g. "brazil"), or ISO code (e.g. "BR")

Details

From the project README

bamwor-mcp-server

MCP Server for world geographic data — 261 countries, 13.4M cities. Connect AI agents to real country and city data.

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Quick Start

npx bamwor-mcp-server

Or install globally:

npm install -g bamwor-mcp-server
bamwor-mcp-server

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "bamwor-world-data": {
      "command": "npx",
      "args": ["-y", "bamwor-mcp-server"],
      "env": {
        "BAMWOR_API_KEY": "your_api_key"
      }
    }
  }
}
Cursor / Windsurf

Add to your MCP settings:

{
  "bamwor-world-data": {
    "command": "npx",
    "args": ["-y", "bamwor-mcp-server"],
    "env": {
      "BAMWOR_API_KEY": "your_api_key"
    }
  }
}
Environment Variables
VariableRequiredDefaultDescription
BAMWOR_API_KEYNo(anonymous)API key for full access. Get one free at bamwor.com/en/developers/quickstart
BAMWOR_API_URLNohttps://bamwor.com/api/v1API base URL override
BAMWOR_REQUEST_TIMEOUTNo15000Request timeout in ms

Available Tools (8)

get_country

Get detailed data about a country by name, slug, or ISO code. Returns population, area, capital, region, coordinates, and 20+ statistics.

Input: { "query": "Japan" }
search_countries

Search for countries by name or keyword. Returns matching countries with basic data.

Input: { "query": "south", "limit": 10 }
search_cities

Search for cities worldwide by name from a database of 13.4M cities.

Input: { "query": "Tokyo", "limit": 5 }
list_cities_by_country

List cities in a specific country, sorted by population or name. Supports minimum population filter.

Input: { "country": "brazil", "min_population": 1000000, "limit": 10 }
compare_countries

Compare two countries side by side across all available metrics: population, area, GDP, HDI, life expectancy, and more.

Input: { "country_a": "France", "country_b": "Germany" }
get_rankings

Get country rankings by metric. Available metrics: population, area, gdp, hdi, life-expectancy, and 9 Bamwor proprietary indices (ibeu, ibcp, ibda, ibcx, ibee, ibfm, ibdi, ibed, ibsa). Omit metric to list all available.

Input: { "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.

Input: { "city_id": 1850147 }
get_nearby_cities

Find cities near a specific city using PostGIS radius search. Returns nearby cities with distance in km.

Input: { "city_id": 1850147, "radius": 50, "limit": 10 }

Data Coverage

  • 261 countries and territories with 20+ statistics each
  • 13.4 million cities with coordinates, population, elevation, timezone
  • 9 proprietary indices (IBEU, IBCP, IBDA, IBCX, IBEE, IBFM, IBDI, IBED, IBSA)
  • Rankings by any metric
  • Country comparisons — 67,860 combinations
  • 4 languages — English, Spanish, Portuguese, Italian

Data sourced from CIA World Factbook, GeoNames, UNDP, and World Bank.

Links

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.