geovicco-dev/bhoonidhi-mcp

An MCP server that lets an AI agent search,
save, download, and cart satellite scenes from ISRO's Bhoonidhi Browse & Order portal
(NRSC) in natural language. An agent can turn a sentence like "Sentinel-2 over
Shillong last January" into a real search against the live portal, see honestly
what is available to download, save a search to reuse later, preview what a
download would fetch, and — once logged in — download open-access scenes or
stage them to the cart.
It is a thin adapter over the
bhoonidhi-downloader
SDK — the same client the bhd CLI uses — so no portal logic is duplicated.
Status
**Search and save with no login; download and cart with one.** The tools reach
the full archive of 41 satellite missions and 79 sensors, search the live
portal, and save searches to reusable slugs — all without credentials.
Downloading open-access scenes and staging scenes to the Bhoonidhi cart need a
login, done out of band with bhd auth login (the server reuses that session).
Tools
| Tool | What it does | Login |
| ------ | -------------- | ------- |
| list_archive | The vocabulary of satellites, sensors, and search tokens the portal supports, live from Bhoonidhi. | no |
| resolve_location | Turns a place name ("Loktak Lake") into a centroid and bounding box. Rejects inputs that are not place names. | no |
| search_scenes | Natural-language scene search over an area and date range. Resolves a casual satellite name to exact tokens, and reports each scene's availability (Ready / Archived / OnOrder / Priced). Stateless — nothing is saved. | no |
| preview_download | A dry run: shows what downloading the results would fetch, and what would be skipped, before anything is downloaded. | no |
| save_query | Persists a search (same arguments as search_scenes) to a reusable slug, so it can be downloaded or staged to the cart later. | no |
| list_queries | Lists saved queries as compact summaries: slug, name, date range, satellites, area, and availability. | no |
| show_query | Returns one saved query by slug, with its scenes. | no |
| remove_query | Deletes a saved query by slug. | no |
| auth_status | Reports whether a login is configured. Never handles a password or token. | no |
| download_query | Downloads a saved query's open-access scenes in the background, to a fixed server-configured root. Returns a job_id at once. | yes |
| download_status | One-off check of a background download by job_id: bytes downloaded, transfer rate, percent when the size is known, and per-scene detail. | no |
| download_wait | Blocks until a download finishes (or a capped timeout), then reports — the efficient primitive a background watcher loops on. | no |
| cart_add | Stages a saved query's scenes to the cart (routes each to ready / on-order / priced). | yes |
| cart_list | Lists scenes currently staged in the cart. | yes |
| cart_remove | Removes scenes from the cart. | yes |
Availability matters: an OpenData scene is not necessarily staged for
download. search_scenes and preview_download distinguish **Ready** (fetch it
now) from **Archived** (open data, but may need a request on the portal first),
so an agent does not over-promise.
Downloads run in the background, independent of the conversation:
download_query returns a job_id at once and the transfer proceeds on its own.
Check progress once with download_status — it reports bytes downloaded, a
transfer rate, and a percent once the size is known — or follow a job to
completion with download_wait, which blocks until it finishes (or a capped
timeout) so an agent can delegate a background watcher and keep the conversation
free instead of sleep-looping. A job lives only as long as the server process,