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
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.
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 GitHubFrom 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.
Live: bharatlas.com · map authoring at collect.bharatlas.com · API docs at bharatlas.com/docs · MCP setup at bharatlas.com/mcp
Contents
- What it does
- Features
- Layers and sources
- Downloads and formats
- Use it from an AI assistant (MCP)
- API
- Releases and the Census 2011 ↔ LGD crosswalk
- Data principles and attribution
- Architecture
- Project layout
- Development
- Deploy
- Contributing
- Security
- Licence
- Credits
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.
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_bywith 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:
| Category | Layers | Examples |
|---|---|---|
| Boundaries | 22 | lgd_states to lgd_villages; SOI, Bhuvan and geoBoundaries alternates; PMGSY blocks and habitations; town and city boundaries (SBM); West Bengal town boundaries (AMRUT) |
| City wards | 41 | wards_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) |
| Water | 22 | WRIS 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 utilities | 13 | pincode polygons, VEDAS power plants and transmission lines, Jal Jeevan Mission facilities, Overture places |
| Environment | 21 | forest 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 places | 13 | parliament and assembly constituencies, high courts, NGT zones, NCLT benches; police station jurisdictions (Andhra Pradesh, Bihar, Delhi, Tamil Nadu, Telangana, marine) |
| Agriculture and land use | 4 | agro-ecological and agro-climatic zones, soil health, land use by block |
| Transport and mobility | 5 | highways, airports, PMGSY roads; Indian Railways stations and tracks |
| Health and education | 4 | NIC HealthGIS health facilities; NHP hospital directory and NIN health facilities (2025); UDISE schools (2.9 million) |
| Economy and finance | 3 | MGNREGA 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:
| Format | Use it for | Layers that have it |
|---|---|---|
| Parquet (GeoParquet) | analysis in DuckDB, pandas, GeoPandas, QGIS | 109 of 109 |
| PMTiles | web maps, including the map view itself | 108 of 109 |
| GeoJSON | web tools, most GIS software | 108 of 109 |
| KML | Google Earth | 104 of 109 |
| Shapefile (zipped) | desktop GIS | 103 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"]
}
}
}
| Client | Config 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:
| Tool | What it does |
|---|---|
list_layers | Find layers by category, level, source or text search |
get_layer_schema | Column names, types and sample values; call before querying |
query_layer | Select columns, filter (exact, case-insensitive), group_by with per-group sums |
locate | Admin boundaries, zones and (in covered cities) the ward that contain a lat/lng |
nearby | Features from a layer within a radius of a point, nearest first |
list_categories | Categories with layer counts |
get_layer_detail | Download URLs, attribution, licence and feature count for one layer |
list_submissions | Community-submitted layers under open licences |
register_map | Register a collect share link; its token sets your scope (view, collect, admin) |
list_my_maps | The collect maps registered on this machine |
get_map | A collect map's metadata and record counts |
get_records | A collect map's records as GeoJSON |
moderate_record | Approve or reject a pending point (admin link) |
import_points | Bulk-import points you hold into a collect map, with a named source (admin link) |
edit_map | Edit a collect map's name, description, purpose, category, data year or base map (admin link) |
publish | Submit a collect map's approved points to the catalog for review (admin link) |
create_map | Optional: 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 byscripts/build_crosswalks.pyfrom 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 MCPget_layer_detailtool return the same attribution and licence, and each/viewpage's Dataset JSON-LD carries acreditTextto 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.htmlandcatalog.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.ymlruns the web tests and build, thenwrangler pages deployto thegeodataPages project. It also runs hourly and rebuilds only when D1 has newly accepted community submissions.collect.ymlbuilds and deploys collect to its own Pages project whencollect/,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:
- Branch off
main:git checkout -b feat/short-name. - Write a test first when you add logic. Pure functions are tested with vitest in
web/tests/andcollect/tests/; pipeline scripts with pytest inscripts/. - Make sure
npm testandnpm run buildpass inweb/(and incollect/if you touched it). - Open a pull request against
main. CI runs the tests and build. - The maintainer reviews and merges. A merge to
maindeploys.
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
- Code: MIT. The MCP server is also MIT (mcp/LICENSE).
- Data: each layer carries its own open licence, named on its card and returned by the API. See Data principles and attribution.
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/nearbycame 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!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.




