Log inSubmit server
Bamwor MCP Server logo

Bamwor MCP Server

by bamwor-dev

Queries global country and city data, including statistics, rankings, comparisons, coordinates, populations, and nearby locations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Bamwor MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "bamwor-dev-bamwor-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "bamwor-mcp-server"
      ],
      "env": {
        "BAMWOR_API_KEY": "YOUR_VALUE_HERE",
        "BAMWOR_API_URL": "YOUR_VALUE_HERE",
        "BAMWOR_REQUEST_TIMEOUT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 8 tools correctly (1mo ago).

Overview

The bamwor-dev/bamwor-mcp-server MCP server gives AI agents access to Bamwor’s geographic API for country and city data. It provides eight MCP tools for searching, retrieving, comparing, ranking, and locating records across 261 countries and 13.4 million cities. Use it for geographic lookups, demographic questions, country comparisons, city discovery, and proximity searches. Anonymous access is supported, while an API key provides full access.

Use cases

  • Look up country statistics by name or ISO code
  • Compare countries across demographic and economic metrics
  • Find cities by name or country
  • Rank countries by population, GDP, HDI, or other metrics
  • Find nearby cities within a radius

Key features

  • Country lookup with 20+ statistics
  • Search across 13.4 million cities
  • Country comparisons and metric rankings
  • City details with coordinates and timezone
  • Nearby-city radius searches
  • Optional API URL and timeout configuration

Tools8

What Bamwor MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

18/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · bamwor-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads159Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed8Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Bamwor MCP Server works

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:

Terminal
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.

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Bamwor MCP Server

Run `npx -y bamwor-mcp-server`, or install it globally with npm and run `bamwor-mcp-server`.

Yes.

No API key is required for anonymous access. `BAMWOR_API_KEY` can be supplied for full access.

Use `search_cities` with a city name and optional limit, or use `list_cities_by_country` to filter cities by country and minimum population.

Yes. `get_nearby_cities` accepts a GeoNames city ID, radius, and limit, and returns nearby cities with distances in kilometers.

Related MCP servers

All in Location Services All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBamwor MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/bamwor-dev-bamwor-mcp-server?style=directory)](https://allmcps.com/mcp/bamwor-dev-bamwor-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/bamwor-dev-bamwor-mcp-server"><img src="https://allmcps.com/api/badge/bamwor-dev-bamwor-mcp-server?style=directory" alt="Bamwor MCP Server on AllMCPs" /></a>