Summary
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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
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
Categories
Registryactive
Packagebamwor-mcp-server
TransportSTDIO
AuthRequired
UpdatedJun 2, 2026
