Bamwor MCP Server

What bamwor-dev/bamwor-mcp-server MCP server does

The bamwor-dev/bamwor-mcp-server MCP server exposes world geographic data through the Model Context Protocol. Its data includes 261 countries and territories, plus a city database containing approximately 13.4 million records. Country records include population, area, capital, region, coordinates, and more than 20 statistics. City records can include population, coordinates, elevation, timezone, province, and country.

The data is sourced from CIA World Factbook, GeoNames, UNDP, and World Bank material. The repository also documents four supported languages: English, Spanish, Portuguese, and Italian.

How it works

The MCP process runs locally through the npm package and makes requests to the Bamwor API. MCP-compatible clients can invoke the tools with structured inputs such as a country name, ISO code, city name, GeoNames city ID, ranking metric, or search limit.

A Bamwor API key is optional for anonymous access but is described as providing full access. The API base URL and request timeout can also be changed through environment variables. Nearby-city searches use a PostGIS radius query and return distances in kilometers.

The bamwor-dev/bamwor-mcp-server MCP server is documented as compatible with Claude Desktop, Cursor, Windsurf, and other MCP-compatible clients.

Setup and configuration

Install and start the server with:

npx -y bamwor-mcp-server

The package can also be installed globally with npm, followed by the bamwor-mcp-server command. For client configuration, add a server entry that runs npx with -y and bamwor-mcp-server as its arguments.

Available environment variables are:

• BAMWOR_API_KEY: Optional API key for full access.
• BAMWOR_API_URL: Optional API base URL override. The documented default is https://bamwor.com/api/v1.
• BAMWOR_REQUEST_TIMEOUT: Optional request timeout in milliseconds. The documented default is 15000.

Tools and capabilities

The bamwor-dev/bamwor-mcp-server MCP server exposes eight tools:

• get_country retrieves detailed country data by name, slug, or ISO code.
• search_countries finds countries by name or keyword, with an optional region filter.
• search_cities searches the global city database by name.
• list_cities_by_country lists cities for a country, sorted by population or name, with an optional minimum-population filter.
• compare_countries compares two countries across available measures such as population, area, GDP, HDI, and life expectancy.
• get_rankings ranks countries by population, area, GDP, HDI, life expectancy, or one of nine Bamwor indices. Omitting the metric lists available metrics.
• get_city retrieves a city by GeoNames ID.
• get_nearby_cities finds cities within a specified radius of another city and includes distance in kilometers.

Limitations and notes

The repository describes coverage and available fields, but it does not guarantee that every record contains every statistic. City detail and proximity tools require a GeoNames city ID rather than only a free-form city name. API access limits, pricing beyond the documented free key, and service availability are not specified in the provided material.

The project is licensed under MIT. The bamwor-dev/bamwor-mcp-server MCP server depends on the external Bamwor API, so changing the API URL or relying on anonymous access may affect the data or access available to a client.