io.github.sathya-sankaran/bharatlas-mcp

NPM · BHARATLAS-MCP · SCANNED AUG 21

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

Available components

61 61 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security98

No malware found by supply-chain analysis.Pass
No known CVEs affecting this package version or its production dependencies.Pass
No install/post-install scripts declared.Pass
30 of 95 dependencies flagged as unhealthy. View diagnostics → Partial

Provenance & Transparency19

Repository check failed: no source repository is declared. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 0 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability67

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 3158 tokens (~185/item across 17 items; 17 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage89

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
67% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · bharatlas-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add sathya-sankaran-bharatlas-mcp -- npx -y bharatlas-mcp

# add to Codex CLI

codex mcp add sathya-sankaran-bharatlas-mcp -- npx -y bharatlas-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sathya-sankaran-bharatlas-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "bharatlas-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add sathya-sankaran-bharatlas-mcp --command npx --arg -y --arg bharatlas-mcp

# ~/.hermes/config.yaml

mcp_servers:
  sathya-sankaran-bharatlas-mcp:
    command: "npx"
    args: ["-y", "bharatlas-mcp"]

// mcp.json

{
  "mcpServers": {
    "sathya-sankaran-bharatlas-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bharatlas-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

21 Aug 26 +15
- Malware scan: unverified → pass ▲ security
20 Aug 26 46

First indexed and scored.

Show 1 earlier entry Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Aug 2026 · Analysed npm/bharatlas-mcp@1.1.1

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	npm

Dependencies 95 packages

Packages resolved	95
Stale	30
Tree resolution	Complete

MCP tools · 17 exposed · ~1,710 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

create_map ~184

Optional: create a collect map programmatically. Most maps are made online at collect.bharatlas.com (no key needed) — prefer that and register_map the link. This path needs COLLECT_API_KEY (the request-only anti-abuse gate) and auto-registers the new admin link.

Input Output Examples

Name	Type	Req	Description
basemap	–	–	–
category	string	–	–
data_year	integer	–	–
description	string	–	–
fields	array	yes	the form for each record (see collect.bharatlas.com/schema/v1.json)
geometry	array	yes	what contributors may add
license	string	–	open licence id; default CC-BY-4.0
moderation	boolean	–	default true — points wait for approval
name	string	yes	3-120 chars
purpose	string	yes	shown to contributors

No output schema declared.

No examples provided.

edit_map ~102

Edit a collect map's settings: name/description/purpose/category/data_year/basemap (needs the admin link). Licence can only change while the map has no records.

Input Output Examples

Name	Type	Req	Description
basemap	string	–	–
category	string	–	–
data_year	integer\|null	–	–
description	string	–	–
id	string	yes	–
license	string	–	–
name	string	–	–
purpose	string	–	–

No output schema declared.

No examples provided.

get_layer_detail ~56

Get full metadata for a single layer: download URLs (parquet, pmtiles, geojson, kml, shapefile), attribution, license, feature count, and level metadata.

Input Output Examples

Name	Type	Req	Description
layer_id	string	yes	Layer ID

No output schema declared.

No examples provided.

get_layer_schema ~73

Get column names, types, and sample values for a layer. Use BEFORE querying to discover what columns exist and what values they contain. Essential for knowing the right column names for filters.

Input Output Examples

Name	Type	Req	Description
layer_id	string	yes	Layer ID (e.g. lgd_states, airports, soi_forests, wards_chennai)

No output schema declared.

No examples provided.

get_map ~43

A collect map's metadata + record counts, plus a link to open it in collect. Any registered scope.

Input Output Examples

Name	Type	Req	Description
id	string	yes	the map (collection) id

No output schema declared.

No examples provided.

get_records ~69

A collect map's records as a GeoJSON FeatureCollection — for reading, analysis, or backup/export. view and collect scope return published points; admin can also read pending/rejected via status.

Input Output Examples

Name	Type	Req	Description
id	string	yes	–
status	string	–	admin only: pending \| published \| rejected

No output schema declared.

No examples provided.

import_points ~96

Bulk-import points you already hold into a collect map (needs the admin link). NOT for synthetic data. Requires a named source + rights confirmation; each row lands with that source as its provenance.

Input Output Examples

Name	Type	Req	Description
id	string	yes	–
records	array	yes	GeoJSON-like {geometry, properties}
rights_confirmed	boolean	yes	you have the right to publish this under the map's licence
source	string	yes	–

No output schema declared.

No examples provided.

list_categories ~16

List all data categories with layer counts.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_layers ~204

List available geo layers. Use to discover what data bharatlas has. Returns layer IDs, names, row counts, categories, and download formats. Filter by category (boundaries, city-wards, environment, water, agriculture, transport, etc.), admin level (state, district, block, village, etc.), source, or text search.

Input Output Examples

Name	Type	Req	Description
category	string	–	Filter by category: boundaries, city-wards, people, environment, water, agriculture, transport, infrastructure, health-edu
level	string	–	Filter by admin level: state, district, subdistrict, block, village, etc.
limit	number	–	Max results (default 20)
offset	number	–	Skip N results for pagination
q	string	–	Text search across layer IDs, sources, and descriptions
source	string	–	Filter by data source: LGD, SOI, Bhuvan, OpenCity, DataMeet, etc.

No output schema declared.

No examples provided.

list_my_maps ~26

List the collect maps you have registered here (local store), each with its scope.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_submissions ~90

List community-submitted geo layers. These are user-contributed datasets under open licenses. Filter by category or search by name.

Input Output Examples

Name	Type	Req	Description
category	string	–	Filter by category
limit	number	–	Max results (default 20)
offset	number	–	Pagination offset
q	string	–	Search name and description
sort	string	–	Sort order (default: recent)

No output schema declared.

No examples provided.

locate ~129

Given a latitude/longitude, find which administrative boundaries, zones, and regions contain that point. Returns state, district, subdistrict, block, parliament/assembly constituency, pincode, seismic zone, high court jurisdiction, and more. The 'where am I?' tool. Also accepts specific layer IDs to check.

Input Output Examples

Name	Type	Req	Description
lat	number	yes	Latitude (6 to 38, India bounding box)
layers	array	–	Specific layer IDs to check (default: 12 essential layers covering all admin levels + zones)
lng	number	yes	Longitude (68 to 98, India bounding box)

No output schema declared.

No examples provided.

moderate_record ~62

Approve or reject one pending point (needs the admin link). Pass the map id it belongs to.

Input Output Examples

Name	Type	Req	Description
id	string	yes	the map (collection) id
reason	string	–	–
record_id	string	yes	–
status	–	yes	–

No output schema declared.

No examples provided.

nearby ~167

Find features from a layer that are near a given point. Samples a grid of points around the center and checks which hit the target layer via locate. Generic: works for any layer type (polygons, points, lines) without needing coordinate columns. Example: 'reservoirs near Bengaluru' -> layer_id: 'wris_reservoirs', lat: 12.97, lng: 77.59, radius_km: 50.

Input Output Examples

Name	Type	Req	Description
lat	number	yes	Center point latitude
layer_id	string	yes	Layer to search for nearby features
limit	number	–	Max results (default 20)
lng	number	yes	Center point longitude
radius_km	number	–	Search radius in kilometres (default 25, max 200)

No output schema declared.

No examples provided.

publish ~50

Bake a collect map's approved points into a bharatlas catalog submission (needs the admin link). Once published it is queryable via list_submissions / query_layer / locate above.

Input Output Examples

Name	Type	Req	Description
id	string	yes	–

No output schema declared.

No examples provided.

query_layer ~225

Query a layer's data with filters and grouping. Reads the parquet file at runtime. Supports: select specific columns, filter by column values, group by a column to get counts. Use get_layer_schema first to discover column names. Examples: 'airports in Karnataka' -> where: {state: 'KA'}, 'forest types' -> group_by: 'type', 'health facilities in Bihar' -> where: {state: 'BIHAR'}, select: ['name', 'type'].

Input Output Examples

Name	Type	Req	Description
group_by	string	–	Column to group by. Returns {value: count} instead of rows.
include_centroid	boolean	–	Include _lat/_lng centroid coordinates (defaults to true). Set false to exclude.
layer_id	string	yes	Layer ID to query
limit	number	–	Max rows (default 100, max 1000)
select	array	–	Column names to return. Omit for all non-geometry columns.
where	object	–	Filter conditions as {column: value} pairs. Case-insensitive matching.

No output schema declared.

No examples provided.

register_map ~118

Register a collect map so this server can act on it. Paste the whole share link (e.g. https://collect.bharatlas.com/c/<id>/admin#<token>). The token in the #fragment sets your scope: admin = full control, collect = add points, view = read published. New maps are created online at collect.bharatlas.com first (no account or key needed); this registers one you already made.

Input Output Examples

Name	Type	Req	Description
link	string	yes	a collect.bharatlas.com share link with the token in the #fragment

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

20 Aug 21 Aug