Skip to main content
Glama
bamwor-mcp-server

bamwor-mcp-server

by bamwor-dev

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

Related 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

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.

License

MIT

Available Tools

5 tools
compare_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

    A3.6/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for the Geomelon geographic API, enabling AI clients to search cities, countries, regions, and languages.
      22
      106 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      6
      48 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Free 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