bamwor-dev avatar

Bamwor Mcp Server

bamwor-dev/bamwor-mcp-server

Connects Claude to Bamwor's geographic database covering 261 countries and 13.4 million cities. Exposes eight tools including country lookups by name or ISO code, city searches with population filters, side-by-side country comparisons across GDP and HDI metrics, and proximity searches using PostGIS radius queries. Also provides rankings by custom indices like IBEU and IBCP alongside standard metrics. Runs via npx without installation and works anonymous or with a free API key for full access. Reach for this when you need structured geographic data beyond what web search can reliably provide, like finding all Brazilian cities over 1M population or comparing France and Germany across 20+ statistics in a single query.

GitHub stars
1
tools
8
auth
Secret needed
transport
STDIO
env var
1
last updated
Jun 2, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

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

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

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

get_rankingsGet 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.

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.

No parameter schema in public metadata yet.

get_cityGet detailed information about a specific city by its GeoNames ID. Returns coordinates, population, elevation, timezone, and province.

Get detailed information about a specific city by its GeoNames ID. Returns coordinates, population, elevation, timezone, and province.

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

Sponsors

Configuration

BAMWOR_API_KEYsecret

Optional. Bamwor API key for full access and higher rate limits. Works anonymously without it. Get one free at https://bamwor.com/en/developers/quickstart

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


View the full README on GitHub

Details

Repository
github.com/bamwor-dev/bamwor-mcp-server
Category
Data & Analytics
Package
bamwor-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1bullrundata avatarMarket Intelligence Mcpbullrundata/market-intelligence-mcpRecession probability, capital rotation scoring, and economic data API1stars
2carvectorio avatarCarvector Mcpcarvectorio/carvector-mcpVehicle specs, federal recalls, complaints, TSBs, investigations and OBD-II DTC data for AI agents.1stars
3chrischall avatarSetlist Mcpchrischall/setlist-mcpsetlist.fm concert data for Claude — setlists, artists, venues, tours, and cities1stars
4cloudcorprecords avatarScholardatacloudcorprecords/scholardataGoogle Scholar as JSON: scholarly search results, case-law opinions and citation formats.1stars
5kdraigo avatarkdraigokdraigo/kdraigo_mcpYour AI writes Go trading strategies; kdraigo backtests them on one-minute Binance and Bybit data.1stars
6sequentum avatarMcpsequentum/sequentum-mcpTurn the web into structured, reliable, actionable enterprise data for AI Agents1stars