by urbanmorph
Provides India's open geo‑data layers through an interactive web map, a public REST API, and a set of MCP tools, allowing browsing, filtering, slicing and downloading in Parquet, PMTiles, GeoJSON and other common formats without any authentication.
Bharatlas aggregates curated geospatial layers covering boundaries, wards, water bodies, infrastructure, environment, health, education and many other domains across India. All layers are openly licensed, viewable on a MapLibre‑based catalog, and downloadable in multiple formats.
https://bharatlas.com/api/v1 (e.g., /layers, /layers/<id>/schema, /layers/<id>/query, /locate, /nearby). No API key is required; requests are rate‑limited per IP.bharatlas-mcp and run it with npx -y bharatlas-mcp@latest. The server exposes 17 read/write tools that LLMs can invoke (e.g., list_layers, query_layer, locate, collect‑related tools).register_map, list_my_maps, publish tools./embed/<id> or serve PMTiles directly in custom web‑mapping applications.Do I need an API key?
No. All public endpoints and read‑only MCP tools are key‑less. Write‑capable Collect operations require a token obtained from the Collect UI or the COLLECT_API_KEY environment variable.
What licenses apply to the data? Each layer carries its own open licence (CC0, CC‑BY, ODbL, GODL‑India, etc.). The API returns attribution and licence details for every layer.
How often is the data refreshed? Upstream sources are fetched by the nightly data pipeline; the catalog reflects the latest available version but may lag by a few days.
Can I add my own dataset? Yes. Use the preview page to upload a file (GeoJSON, KML, GPX, TCX, Parquet) and submit it for curator review. Community layers appear after approval.
How do I run the MCP server locally?
Install the npm package and start it with npx -y bharatlas-mcp@latest. For Collect‑related tools set COLLECT_API_KEY in the environment.
What formats are available for downloads? Parquet (GeoParquet), PMTiles, GeoJSON, KML, and Shapefile are provided for the majority of layers.
Is there rate limiting? Yes—requests are limited per IP address to protect the service.
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
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 view | City ward map | Mobile |
|---|---|---|
![]() |
![]() |
![]() |
/view/<id>): each layer on a MapLibre map with a base map choice, filter and download, and its own share card.?at= point) and lets you zoom to it or share it./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./c/<id>): published submissions, reviewed by a curator before they appear, each with its source, licence and a "useful" vote./embed/<id>): an iframe of any map, plus PNG export./api/v1): list, schema, query, filter, group_by with per-group sums, locate (point-in-polygon across layers) and nearby (features within a radius).bharatlas-mcp): 17 tools for LLMs, for reading the catalog and for authoring collect maps. Also shipped as a Claude Code plugin.The live catalog lists 138 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 | 21 | lgd_states to lgd_villages; SOI, Bhuvan and geoBoundaries alternates; PMGSY blocks and habitations; town and city boundaries (SBM) |
| City wards | 35 | wards_bengaluru_gba, wards_chennai, wards_mumbai, wards_delhi; BDA jurisdiction and layouts; sbm_wards (about 3,300 towns and cities) |
| 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 | 3 | highways, airports, PMGSY roads |
| Health and education | 4 | NIC HealthGIS health facilities; NHP hospital directory and NIN health facilities (2025); UDISE schools (2.9 million) |
| Economy and finance | 2 | 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 |
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.
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.
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.
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.
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.
web/public/ward-index/<layer>.json), credited to their own source, and are not in the downloads.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).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.
*.template.html and catalog.json.web/functions/) serve the REST API, submissions, votes, the sitemap, OG images and the edge-rendered /view/<id> and /c/<id> pages.collect/functions/).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.
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.
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.
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:
main: git checkout -b feat/short-name.web/tests/ and collect/tests/; pipeline scripts with pytest in scripts/.npm test and npm run build pass in web/ (and in collect/ if you touched it).main. CI runs the tests and build.main deploys.Commit messages: a short subject; the body explains why, not what. See git log for examples.
Report vulnerabilities to sathya@urbanmorph.com rather than in a public issue. You will get an acknowledgement within 72 hours.
Data sources:
Pipelines and patterns:
/api/v1/nearby came from this review.Built by Urban Morph · Sathya Sankaran. Star the repo if you find it useful.
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by mindsdb
Enables humans, AI agents, and applications to retrieve highly accurate answers across large‑scale data sources, unifying heterogeneous databases, warehouses, and SaaS platforms.
by mckinsey
Build high-quality data visualization apps quickly using a low-code toolkit that leverages Plotly, Dash, and Pydantic.
by antvis
Offers over 25 AntV chart types for automated chart generation and data analysis, callable via MCP tools, CLI, HTTP, SSE, or streamable transports.
by dbt-labs
Provides a Model Context Protocol server that exposes a rich set of dbt‑related tools—SQL execution, semantic‑layer queries, discovery APIs, dbt CLI commands, admin operations, code generation, lineage analysis, and product documentation retrieval—so AI agents can safely interact with dbt projects and platforms.
by reading-plus-ai
A versatile tool that enables interactive data exploration through prompts, CSV loading, and script execution.
by Canner
Provides a semantic engine that lets MCP clients and AI agents query enterprise data with contextual understanding, precise calculations, and built‑in governance.
by surendranb
Provides natural‑language access to Google Analytics 4 data via MCP, exposing over 200 dimensions and metrics for Claude, Cursor and other compatible clients.
by OpenLabs-so
Provides privacy‑first, cookieless web analytics with revenue attribution and an MCP server, enabling self‑hosted tracking without cookies or cross‑site identifiers.
by ergut
Provides secure, read‑only access to BigQuery datasets, allowing large language models to query and analyze data through a standardized interface.
{
"mcpServers": {
"bharatlas": {
"command": "npx",
"args": [
"-y",
"bharatlas-mcp@latest"
],
"env": {
"COLLECT_API_KEY": "<YOUR_API_KEY>"
}
}
}
}claude mcp add bharatlas npx -y bharatlas-mcp@latest