bamwor-mcp-server
bamwor-mcp-server provides AI agents with access to comprehensive global geographic data covering 261 countries and 13.4 million cities.
Get country details — Retrieve population, area, capital, region, coordinates, and 20+ statistics for any country by name, slug, or ISO code
Search countries — Find countries by name or keyword (up to 50 results)
Search cities — Look up cities from a database of 13.4 million cities by name or partial name
List cities by country — Browse cities within a specific country, filterable by minimum population and sortable by population or name
Compare countries — Side-by-side comparison of two countries across population, area, GDP, HDI, life expectancy, and more
Country rankings — Get rankings by population, area, GDP, HDI, life expectancy, and 9 proprietary Bamwor indices
City details — Retrieve coordinates, population, elevation, timezone, and province for a specific city via GeoNames ID
Nearby cities — Find cities near a given location within a specified radius
Multi-language support — Data available in English, Spanish, Portuguese, and Italian
Compatible with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.
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-serverOr install globally:
npm install -g bamwor-mcp-server
bamwor-mcp-serverRelated MCP server: geomelon-mcp
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 |
| No | (anonymous) | API key for full access. Get one free at bamwor.com/en/developers/quickstart |
| No |
| API base URL override |
| No |
| 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
Available Tools
5 toolscompare_countriesC
Compare two countries side by side across all available metrics: population, area, GDP, HDI, life expectancy, and more.
Inputs: country_a (required), country_b (required).
get_countryB
Get detailed data about a country by name, slug, or ISO code. Returns population, area, capital, region, coordinates, and 20+ statistics.
Inputs: query (required).
list_cities_by_countryB
List cities in a specific country, sorted by population or name. Supports minimum population filter. Covers 13.4M cities globally.
Inputs: country (required), min_population, limit, sort.
search_citiesB
Search for cities worldwide by name. Returns matching cities from a database of 13.4M cities with population and country.
Inputs: query (required), limit.
search_countriesB
Search for countries by name or keyword, with optional region filter. Returns a list of matching countries with basic data.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap: compare_countries compares two countries, get_country retrieves detailed data for one country, list_cities_by_country lists cities within a country, search_cities searches cities globally, and search_countries searches countries. The descriptions make it unambiguous which tool to use for each task.
All tool names follow a consistent verb_noun pattern (e.g., compare_countries, get_country, list_cities_by_country, search_cities, search_countries). The verbs are clear and descriptive, and there are no deviations in naming style throughout the set.
With 5 tools, this server is well-scoped for its geographic data domain. Each tool serves a specific and necessary function (comparing, retrieving, listing, and searching for countries and cities), and none feel redundant or missing for the apparent purpose.
The tool set provides strong coverage for querying and comparing country and city data, including search, retrieval, and comparison operations. A minor gap is the lack of update or creation tools, but this is reasonable for a read-only data server focused on geographic information, so agents can still perform core tasks effectively.
Related MCP Connectors
MCP server for Japan geodata: cadastral lot numbers (chiban) and reverse geocoding, for AI agents.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Geospatial AI MCP server — satellite imagery, embeddings, weather, GNS governance
Agent-native MCP server over 49M+ US public and government records, privacy-first, always current.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP Server that gives AI assistants access to comprehensive country data from 250+ countries.1MIT
- AlicenseAqualityCmaintenanceMCP server for the Geomelon geographic API, enabling AI clients to search cities, countries, regions, and languages.22106 npm1MIT
- AlicenseAqualityDmaintenanceMCP server for spatial queries via the Terranode Geospatial API, enabling AI agents to perform point-in-polygon lookups, nearest feature search, distance calculations, and spatial joins.648 npmMIT
- AlicenseNot gradedqualityCmaintenanceFree geospatial MCP server for AI agents, providing geocoding, reverse geocoding, POI search, and route planning using OpenStreetMap data via Nominatim, Overpass, and OSRM.GPL 3.0