Bamwor Mcp Server

io.github.bamwor-devPublished by GitHub account bamwor-devv0.2.2Updated Oct 24, 2026

World geographic data for AI agents: 261 countries, 5.2M cities, rankings, and 9 indexes.

VerifiedSTDIODesktop onlyLocation & LifestyleData & Analytics

Overview

AI-generated overview

A local MCP server that gives an assistant world geographic data: country profiles, city search, rankings, comparisons and nearby-city lookups.

What you can do
Look up and search countries by name, slug or ISO code, with population, area, capital and statistics, and compare two countries side by side across metrics such as GDP, HDI and life expectancy. Search cities worldwide or list cities in a country filtered by minimum population. Retrieve a city's details by GeoNames ID, including coordinates, elevation and timezone, and find cities within a radius of it. Get country rankings by population, area, GDP, HDI, life expectancy or nine proprietary Bamwor indices.
When to use it
Useful when an assistant needs factual country or city data for research, comparisons, rankings or location context, without building its own geographic dataset. It fits analysis and writing tasks that involve places rather than live maps or routing.
Requirements
Runs locally via npx or a global npm install, so Node.js is needed. It calls the Bamwor API over the network; an optional BAMWOR_API_KEY raises access and rate limits, and the API base URL and request timeout can be overridden by environment variables.
Before you install
The API key is passed in plain text through the environment; keep it out of shared configuration files. Queries are sent to the third-party Bamwor API, so the places and terms you look up leave your machine. Data is read-only, but figures come from external sources and proprietary indices, so verify important results.

Installation

In SourceWeft

  1. Open Bamwor Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
npx bamwor-mcp-server

Or install globally:

bash
npm install -g bamwor-mcp-serverbamwor-mcp-server

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

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:

json
{  "bamwor-world-data": {    "command": "npx",    "args": ["-y", "bamwor-mcp-server"],    "env": {      "BAMWOR_API_KEY": "your_api_key"    }  }}

Environment Variables

VariableRequiredDefaultDescription
BAMWOR_API_KEYNo(anonymous)API key for full access. Get one free at bamwor.com/en/developers/quickstart
BAMWOR_API_URLNohttps://bamwor.com/api/v1API base URL override
BAMWOR_REQUEST_TIMEOUTNo15000Request 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

Source: README.md at commit 8ce0b15

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts