About io.github.bamwor-dev/bamwor-mcp-server
io.github.bamwor-dev/bamwor-mcp-server is an MCP server in the Maps category: world geographic data for AI agents. 261 countries, 13.4M cities.
Install
claude mcp add io-github-bamwor-dev-bamwor-mcp-server -- npx -y bamwor-mcp-servernpx -y bamwor-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
compare_countriesCompare two countries side by side across all available metrics: population, area, GDP, HDI, life expectancy, and more.
Parameters not published.
get_cityGet detailed information about a specific city by its GeoNames ID. Returns coordinates, population, elevation, timezone, province, and country.
Parameters not published.
get_countryGet detailed data about a country by name, slug, or ISO code. Returns population, area, capital, region, coordinates, and 20+ statistics.
Parameters not published.
get_nearby_citiesFind cities near a specific city using PostGIS radius search. Returns nearby cities with distance in kilometers.
Parameters not published.
get_rankingsGet country rankings by metric. Available: population, area, gdp, hdi, life-expectancy, and 9 Bamwor indices (ibeu, ibcp, ibda, ibcx, ibee, ibfm, ibdi, ibed, ibsa). Omit metric to list all.
Parameters not published.
list_cities_by_countryList cities in a specific country, sorted by population or name. Supports minimum population filter. Covers 13.4M cities globally.
Parameters not published.
search_citiesSearch for cities worldwide by name. Returns matching cities from a database of 13.4M cities with population and country.
Parameters not published.
search_countriesSearch for countries by name or keyword, with optional region filter. Returns a list of matching countries with basic data.
Parameters not published.
Ask AI
Ask AI about io.github.bamwor-dev/bamwor-mcp-server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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
| Variable | Required | Default | Description |
|---|---|---|---|
BAMWOR_API_KEY |
No | (anonymous) | API key for full access. Get one free at bamwor.com/en/developers/quickstart |
BAMWOR_API_URL |
No | https://bamwor.com/api/v1 |
API base URL override |
BAMWOR_REQUEST_TIMEOUT |
No | 15000 |
Request 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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.