Back to Browse

Geodata MCP Server

Developer ToolsLow Risk8.5MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

Query India's open geo data, and author collect maps: register a link, moderate, publish.

About

Query India's open geo data, and author collect maps: register a link, moderate, publish.

Remote endpoints: streamable-http: https://bharatlas.com/mcp

Security Report

8.5
Low Risk8.5Low Risk

Valid MCP server (2 strong, 5 medium validity signals). 2 known CVEs in dependencies (0 critical, 1 high severity) Package registry verified. Imported from the Official MCP Registry.

8 tools verified · Open access · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

bharatlas

India's open geo data in one place: browse, filter and download curated layers, look up your ward, share your own maps, and query it all from an AI assistant.

ci bharatlas.com Lighthouse: 98+ hosted on Cloudflare code licence: MIT data: per-layer open licences npm: bharatlas-mcp MCP Registry bharatlas MCP server: tool definition quality on Glama bharatlas MCP connector: tool definition quality and endpoint health on Glama bharatlas MCP server on mcptry Listed on mcpservers.org

Live: bharatlas.com · map authoring at collect.bharatlas.com · API docs at bharatlas.com/docs · MCP setup at bharatlas.com/mcp

The bharatlas catalog on desktop

Contents

What it does

bharatlas is a catalog of India's open geo layers, from the national boundary down to villages and city wards, with water, environment, infrastructure, transport, health and agriculture layers alongside. Every layer opens on a map, can be filtered and sliced, and downloads whole in several formats. Anyone can add a layer under an open licence, or gather points from the field with collect. The same data is available through a REST API and an MCP server for LLMs. Reading needs no account and no API key.

Layer viewCity ward mapMobile
LGD districts on the mapBengaluru's 369 GBA wardsThe catalog on a phone

Features

  • Catalog: India national boundary, then state, district, subdistrict, block, gram panchayat and village (LGD), with cross-source alternates (SOI, Bhuvan, geoBoundaries, PMGSY) shown as "also: ..." on each card. City wards, electoral constituencies, wildlife areas, eco-sensitive zones, rivers, canals, groundwater, floods, seismic zones, highways, hospitals, pincodes and more.
  • View (/view/<id>): each layer on a MapLibre map with a base map choice, filter and download, and its own share card.
  • Filter and slice: facets, ranges and typeahead search built from each layer's schema. Export the slice in any download format.
  • My ward / My district: on ward and admin layers, a locate button finds the polygon you are standing in (or a shared ?at= point) and lets you zoom to it or share it.
  • Preview (/preview): drop a GeoJSON, KML, KMZ, GPX, TCX or Parquet file to render and validate it in the browser. Nothing is uploaded until you choose Publish.
  • Community layers (/c/<id>): published submissions, reviewed by a curator before they appear, each with its source, licence and a "useful" vote.
  • Embed (/embed/<id>): an iframe of any map, plus PNG export.
  • Collect (collect.bharatlas.com): design a small form, share a link, and anyone with it adds points, lines and areas from their phone with no account. Review contributions, then download them or publish to the catalog. Links are token-scoped (view, collect, admin).
  • API (/api/v1): list, schema, query, filter, group_by with per-group sums, locate (point-in-polygon across layers) and nearby (features within a radius).
  • MCP server (bharatlas-mcp): 17 tools for LLMs, for reading the catalog and for authoring collect maps. Also shipped as a Claude Code plugin.

Layers and sources

The live catalog lists 148 layers (GET /api/v1/layers, checked 15 November 2026), plus community submissions (GET /api/v1/submissions). Counts by category, from GET /api/v1/categories:

CategoryLayersExamples
Boundaries22lgd_states to lgd_villages; SOI, Bhuvan and geoBoundaries alternates; PMGSY blocks and habitations; town and city boundaries (SBM); West Bengal town boundaries (AMRUT)
City wards41wards_bengaluru_gba, wards_chennai, wards_mumbai, wards_delhi; BDA jurisdiction and layouts; sbm_wards (about 3,300 towns and cities); Kalyan-Dombivli wards; Pune 2025 administrative wards; zones for Greater Bengaluru, Pune and Chennai; West Bengal wards (AMRUT, 52 towns)
Water22WRIS rivers, canals, basins, dams, reservoirs; CGWB aquifers and groundwater extraction; groundwater quality pre- and post-monsoon (Bhuvan); Amrit Sarovar ponds; India Flood Inventory; NDEM floods 1998-2022
Infrastructure and utilities13pincode polygons, VEDAS power plants and transmission lines, Jal Jeevan Mission facilities, Overture places
Environment21forest circles, divisions, ranges and beats (FSI); wildlife sanctuaries, reserves and corridors; eco-sensitive zones; Coastal Regulation Zones 2019; geology, coal blocks, critical minerals and lineaments (GSI); seismic zones, landslides, earthquakes, cyclone tracks
People and places13parliament and assembly constituencies, high courts, NGT zones, NCLT benches; police station jurisdictions (Andhra Pradesh, Bihar, Delhi, Tamil Nadu, Telangana, marine)
Agriculture and land use4agro-ecological and agro-climatic zones, soil health, land use by block
Transport and mobility5highways, airports, PMGSY roads; Indian Railways stations and tracks
Health and education4NIC HealthGIS health facilities; NHP hospital directory and NIN health facilities (2025); UDISE schools (2.9 million)
Economy and finance3MGNREGA by district (2025-26): spending, wages, persondays, households, women, SC and ST work, with yearly spend since 2018-19; city finances from CityFinance.in: income and expenditure by account head for about 3,000 towns and cities; state economy and finance: GSDP, per-capita NSDP, debt, GST and direct tax, MUDRA, KCC and Jan Dhan accounts

The full catalog, with each layer's source, licence, row count, freshness and download sizes, lives in catalog.json and on bharatlas.com. Known data caveats (name spellings across sources, coverage gaps, polygon precision) are on /about#caveats.

Downloads and formats

Each layer downloads whole from its card or its view page:

FormatUse it forLayers that have it
Parquet (GeoParquet)analysis in DuckDB, pandas, GeoPandas, QGIS109 of 109
PMTilesweb maps, including the map view itself108 of 109
GeoJSONweb tools, most GIS software108 of 109
KMLGoogle Earth104 of 109
Shapefile (zipped)desktop GIS103 of 109

The files are served from Cloudflare R2. GET /api/v1/layers/<id> returns the URL and size of each format the layer has. A filtered slice exports from the Filter panel in the same formats. Very large layers (gram panchayats, villages) are best sliced by state in the viewer or read from the parquet.

Use it from an AI assistant (MCP)

bharatlas-mcp is a stdio MCP server published on npm and in the official MCP Registry as io.github.sathya-sankaran/bharatlas-mcp (v1.4.0). It is also listed on Glama, as the repository and as the hosted connector. Read tools need no key; collect tools act only on maps whose share link you register.

Hosted, nothing to install. The eight read tools also run at https://bharatlas.com/mcp (Streamable HTTP, no key, read-only). Add it as a custom connector in Claude.ai or ChatGPT, or:

claude mcp add --transport http bharatlas https://bharatlas.com/mcp

The collect (authoring) tools need the npm package below, which keeps share links on your machine.

Any MCP client. Add this to the client's config:

{
  "mcpServers": {
    "bharatlas": {
      "command": "npx",
      "args": ["-y", "bharatlas-mcp@latest"]
    }
  }
}
ClientConfig file
Claude Code.mcp.json (project root) or ~/.claude.json
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
VS Code.vscode/mcp.json

Claude Code, as a plugin (updates with each release) or as a plain server:

/plugin marketplace add urbanmorph/geodata
/plugin install bharatlas@bharatlas

claude mcp add bharatlas -- npx -y bharatlas-mcp@latest

To try the tools without an LLM: npx @modelcontextprotocol/inspector npx bharatlas-mcp@latest.

Tools

From mcp/index.js:

ToolWhat it does
list_layersFind layers by category, level, source or text search
get_layer_schemaColumn names, types and sample values; call before querying
query_layerSelect columns, filter (exact, case-insensitive), group_by with per-group sums
locateAdmin boundaries, zones and (in covered cities) the ward that contain a lat/lng
nearbyFeatures from a layer within a radius of a point, nearest first
list_categoriesCategories with layer counts
get_layer_detailDownload URLs, attribution, licence and feature count for one layer
list_submissionsCommunity-submitted layers under open licences
register_mapRegister a collect share link; its token sets your scope (view, collect, admin)
list_my_mapsThe collect maps registered on this machine
get_mapA collect map's metadata and record counts
get_recordsA collect map's records as GeoJSON
moderate_recordApprove or reject a pending point (admin link)
import_pointsBulk-import points you hold into a collect map, with a named source (admin link)
edit_mapEdit a collect map's name, description, purpose, category, data year or base map (admin link)
publishSubmit a collect map's approved points to the catalog for review (admin link)
create_mapOptional: create a collect map headlessly; needs COLLECT_API_KEY. Most maps are made at collect.bharatlas.com

Registered collect links are stored in ~/.bharatlas-mcp.json (override with COLLECT_MCP_STORE). More in mcp/README.md.

API

Base URL https://bharatlas.com/api/v1. No API key; rate-limited per IP. Full reference: bharatlas.com/docs.

# every catalog layer
curl 'https://bharatlas.com/api/v1/layers'

# a layer's columns and sample values, before querying
curl 'https://bharatlas.com/api/v1/layers/lgd_districts/schema'

# how many districts per state
curl 'https://bharatlas.com/api/v1/layers/lgd_districts/query?group_by=stname'

# every boundary and zone at a point
curl 'https://bharatlas.com/api/v1/locate?lat=12.9716&lng=77.5946'

# health facilities within 10 km of a point
curl 'https://bharatlas.com/api/v1/nearby?lat=12.9716&lng=77.5946&layer=nic_health&radius_km=10'

collect has its own token-authenticated write API at https://collect.bharatlas.com/api/collect/v1.

Releases and the Census 2011 ↔ LGD crosswalk

Dated, immutable releases, each named by a code bharatlas-<dataset>-<year>.<month> that is never reused and pinned by SHA-256 (<code>+sha256:<hex>, the hex being the SHA-256 of the release's SHA256SUMS). The index is /releases/index.json (also GET /api/v1/releases); each release lives at https://bharatlas.com/releases/<code>/ with manifest.json (per file: SHA-256, bytes, rows, licence; the source credited first with its version and fetch date), CHANGES.md and SHA256SUMS. The numbering follows the schemes register (schemes-register-2026.11): the month a release is cut, so one release per dataset a month.

  • bharatlas-cw-…: the Census 2011 ↔ LGD crosswalk, one table per level (cw_states, cw_districts, cw_subdistricts, cw_blocks, cw_villages; CSV and Parquet), built by scripts/build_crosswalks.py from the Census 2011 codes the LGD layers already carry. Each row is an LGD code, its name, the 2011 code, and a relation derived from how the codes repeat (1:1, split, merge, split+merge, post-2011 code, no 2011 code, no LGD code). The source gives districts made after 2011 a code past 640 instead of their parent's, so a new district's parent is not in this data; splits show at the subdistrict, block and village levels. Each table keeps its LGD layer's licence.
  • bharatlas-catalog-…: the dated catalogue record (scripts/catalog_record.py): per layer the source, the source's own version (a GitHub release asset's digest where there is one), fetch date, SHA-256 of the served file, licence and source link.

Cut with scripts/release.py: manifests are committed under web/public/releases/<code>/; data files go to R2 at releases/<code>/ and /releases/<code>/<file> redirects there. A re-run with the same files changes nothing; different files under an existing code are refused. No DOIs for now; w3id.org/bharatlas/<dataset>/<year>.<month> is the proposed persistent address.

python3 scripts/build_crosswalks.py                 # -> data/release-staging/cw/
python3 scripts/catalog_record.py                   # -> data/release-staging/catalog/ (downloads every served file once; cached, resumable)
python3 scripts/release.py data/release-staging/cw data/release-staging/catalog   # prints the R2 upload commands

Data principles and attribution

  • Downloads are the source layer as published. A layer's files keep the attributes its source published. bharatlas does not edit, correct or rename boundaries or place names.
  • View-only enrichment lives in sidecars. Extras that help people read a map, such as the OpenStreetMap area names shown on number-only ward maps, are kept in separate sidecar files (web/public/ward-index/<layer>.json), credited to their own source, and are not in the downloads.
  • How sources are chosen. Curated layers come from Indian government bodies, public institutions, open-data communities (DataMeet, OpenCity) and openly licensed research and industry datasets, favouring data a map app doesn't have: official jurisdictions, regulatory zones, measured records. Publicly funded government geodata is republished with full credit to the publishing department (National Geospatial Guidelines 2021, National Geospatial Policy 2022), including where a portal's general website terms ask for permission. Data under an explicit non-commercial licence, privately owned data without an open licence, and personal data are left out. Where the publisher states an open licence (GODL-India, CC BY) the layer carries it; where it states none, the layer carries the republisher's licence (for example CC0 from indianopenmaps) and credits both. Publishers can ask for a correction, different credit or removal: /about#sources-and-licensing.
  • Each layer keeps its own source and licence. Curated layers carry CC0-1.0, CC-BY-4.0, CC-BY-SA-4.0, ODbL-1.0, GODL-India, MIT, or CDLA-Permissive-2.0 / Apache-2.0, depending on the upstream source. Community submissions choose from an open-licence allowlist (CC0, CC-BY, CC-BY-SA, ODbL, ODC-PDDL, GODL-India, CDLA Permissive 2.0).
  • Credit the source when you use a layer. Every card and view page names the layer's source and licence. GET /api/v1/layers/<id> and the MCP get_layer_detail tool return the same attribution and licence, and each /view page's Dataset JSON-LD carries a creditText to reproduce. Follow that licence's terms (for example, attribution for CC-BY, share-alike for ODbL and CC-BY-SA).
  • Provided as-is. Curated layers reflect the upstream source at fetch time and can lag. For legal or administrative use, go to the upstream source. Full terms: /about#use-of-data.

bharatlas follows the People's Digital Goods and Infrastructure (PDGI) principles. PDGI.md scores how each one is implemented and where it still falls short.

Architecture

  • Frontend: vanilla TypeScript, Vite, MapLibre GL JS, PMTiles, DuckDB-WASM (lazy-loaded). Pages are prerendered from *.template.html and catalog.json.
  • Edge: Cloudflare Pages Functions (web/functions/) serve the REST API, submissions, votes, the sitemap, OG images and the edge-rendered /view/<id> and /c/<id> pages.
  • Queries: hyparquet reads parquet from R2 at request time; spatial queries use PMTiles reads with MVT decoding, point-in-polygon and Haversine distance.
  • Storage: Cloudflare R2 for data files; D1 (SQLite) for submissions, votes and collect records.
  • Anti-abuse: Cloudflare Turnstile and per-IP rate limits.
  • collect: a separate Vite app and Pages project with its own API (collect/functions/).
  • MCP: a thin Node wrapper over the REST and collect APIs.

Project layout

web/                  bharatlas.com: viewer (src/), Pages Functions (functions/), D1 migrations (migrations/), tests (tests/)
collect/              collect.bharatlas.com: map-capture app and its API (functions/)
shared/               code shared by web and collect (base map style, imagery, passkeys)
mcp/                  bharatlas-mcp, the MCP server published to npm
plugins/claude-code/  Claude Code plugin; .claude-plugin/marketplace.json lists it
scripts/              Python and shell data pipeline: fetch, bake formats, build the catalog, upload to R2, moderation
catalog.json          curated-layer index; the single source of truth for the viewer
docs/screenshots/     images for this README (not part of the site build)
PDGI.md               PDGI principles scorecard

Large data files (sources/, data/) are not in git; they live in R2. scripts/fetch.sh pulls the upstream parquet and PMTiles from yashveeeeeeer/india-geodata to rebuild locally.

Development

Requires Node 22.5 or later (CI uses Node 24) and Python 3 for the data scripts.

git clone https://github.com/urbanmorph/geodata.git
cd geodata/web
npm ci
npm test              # prerenders the pages, then runs the vitest suite
npm run dev           # http://localhost:5173 (viewer only; run npm test or npm run build first to generate the pages)
npx tsc --noEmit -p . # type check
npm run build         # prerender, test, then vite build into dist/

npm test runs node scripts/prerender.mjs before vitest. On a fresh clone, plain npx vitest run fails until the pages have been prerendered once.

collect and the MCP server:

cd collect && npm ci && npm test   # npm run build also type-checks
cd mcp && npm ci && node test.js   # functional tests against the live API

Data pipeline tests:

PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest scripts/ -q

The full submission flow (D1, R2, Turnstile, Pages Functions) needs the bindings in web/wrangler.toml.

Deploy

GitHub Actions deploys on every push to main:

  • ci.yml runs the web tests and build, then wrangler pages deploy to the geodata Pages project. It also runs hourly and rebuilds only when D1 has newly accepted community submissions.
  • collect.yml builds and deploys collect to its own Pages project when collect/, shared/ or the web files it imports change.

Pull requests build and test but do not deploy. MCP releases are published to npm and the MCP Registry by hand.

Contributing

Data: drop a file on bharatlas.com/preview and publish it under an open licence, or gather it with collect. A curator reviews each submission before it appears.

Code:

  1. Branch off main: git checkout -b feat/short-name.
  2. Write a test first when you add logic. Pure functions are tested with vitest in web/tests/ and collect/tests/; pipeline scripts with pytest in scripts/.
  3. Make sure npm test and npm run build pass in web/ (and in collect/ if you touched it).
  4. Open a pull request against main. CI runs the tests and build.
  5. The maintainer reviews and merges. A merge to main deploys.

Commit messages: a short subject; the body explains why, not what. See git log for examples.

Security

Report vulnerabilities to sathya@urbanmorph.com rather than in a public issue. You will get an acknowledgement within 72 hours.

Licence

Credits

Data sources:

  • LGD: Local Government Directory, the authoritative admin code chain from state to village; also constituencies, high courts, NGT zones and NCLT benches.
  • SOI: Survey of India; admin alternates, forests, village points.
  • Bhuvan and NDEM (NRSC/ISRO): admin alternates; floods, landslide hazard, cyclone tracks.
  • OpenCity (Oorvani Foundation): city ward, corporation and jurisdiction polygons.
  • DataMeet: community-curated municipal spatial data.
  • datta07/INDIAN-SHAPEFILES: metropolitan city ward shapefiles; Patna wards cleaned by Jayesh Keswani.
  • Central Water Commission (India-WRIS): basins, rivers, canals, dams, reservoirs, lakes, waterbodies.
  • ramSeraph/indianopenmaps: selectively republished layers (WRIS waterbodies, SLUSI watersheds and soil, VEDAS power infrastructure, PMGSY roads and habitations, Swachh Bharat Mission urban wards and town boundaries, NHP hospitals and NIN health facilities, UDISE schools).
  • CoRE Stack: republished CGWB aquifers and groundwater extraction, WRIS canals, ICAR-NBSS agro-ecological zones, Planning Commission agro-climatic zones, Wildlife Institute of India biogeographic zones.
  • PMGSY: rural blocks, roads and habitations.
  • PM GatiShakti: wildlife sanctuaries, national parks, highways.
  • Bharatmaps (NIC): eco-sensitive zones, dams, Ramsar sites, wetlands.
  • NIC HealthGIS: health facilities.
  • Swachh Bharat Mission (Urban), MoHUA: ward and town boundaries for about 3,300 urban local bodies (via ramSeraph, CC0).
  • ISRO VEDAS Energymap: power plants, refineries, oil wells, wind and solar.
  • Geological Survey of India and NGDR / Bhukosh: landslide inventory, earthquakes.
  • Minor Irrigation Census (Ministry of Jal Shakti): district well counts.
  • Overture Maps Foundation: points of interest.
  • bharatviz (Saket Choudhary, MIT): India Post pincode polygons.
  • geoBoundaries: independent cross-check.
  • data.gov.in: airports, seismic zones, pincodes and other government open data.
  • OpenStreetMap contributors (ODbL): area names in ward views (view only).

Pipelines and patterns:

  • yashveeeeeeer/india-geodata: upstream Parquet and PMTiles republisher for LGD, SOI, Bhuvan, PMGSY, GatiShakti, Bharatmaps, CWC, NIC-Health and the India Flood Inventory.
  • ramSeraph: guidance on GeoParquet for spatial queries (issue #100). The Hilbert sort, flat bbox columns and density-aware row groups behind /api/v1/nearby came from this review.
  • mdshare: the anonymous-token contribution pattern.

Built by Urban Morph · Sathya Sankaran. Star the repo if you find it useful.

Reviews

No reviews yet

Be the first to review this server!