Log inSubmit server
Bhoonidhi MCP logo

Bhoonidhi MCP

Search, save, preview, download, and cart satellite scenes from ISRO's Bhoonidhi portal through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Bhoonidhi MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "bhoonidhi-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/geovicco-dev/bhoonidhi-mcp",
        "bhoonidhi-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

uvx --from git+https://github.com/geovicco-dev/bhoonidhi-mcp bhoonidhi-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 2d ago.

Overview

The bhoonidhi-mcp MCP server connects AI agents to ISRO's Bhoonidhi Browse & Order portal for satellite-scene discovery and management. It resolves locations, searches the live archive by natural-language area and date criteria, reports scene availability, and saves reusable queries. Logged-in users can download open-access scenes in background jobs or stage scenes in the Bhoonidhi cart. Use it when an agent needs to find Indian remote-sensing imagery and distinguish ready, archived, on-order, and priced scenes before taking action.

Use cases

  • Find satellite scenes over a named location and date range
  • Check which Bhoonidhi scenes are ready to download
  • Save searches for later download or cart staging
  • Monitor background scene downloads
  • Stage priced or on-order scenes in the Bhoonidhi cart

Key features

  • Natural-language satellite scene search
  • Place-name geocoding to centroid and bounding box
  • Live archive vocabulary discovery
  • Reusable saved queries
  • Background downloads with progress reporting
  • Bhoonidhi cart management

Tools15

What Bhoonidhi MCP lets your agent do. Expand a tool for its parameters.

Self-reported~411 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

4/4 checks healthy over the last 42d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · bhoonidhi-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
Last commit4d agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed15Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Bhoonidhi MCP works

What bhoonidhi-mcp does

The bhoonidhi-mcp MCP server gives an AI agent access to ISRO's Bhoonidhi Browse & Order portal through a Python MCP process. It covers archive discovery, geographic lookup, scene search, saved searches, download preparation, background transfers, and cart operations.

Searches can use ordinary descriptions such as a satellite name, place, and date range. The server matches casual satellite references to the portal's supported tokens and returns availability for each result. That distinction is important: a scene can be open data but still archived, while other scenes may be ready, on order, or priced.

The server is an adapter over the bhoonidhi-downloader SDK, which is also used by the bhd command-line client.

How it works

resolve_location converts a place name into a centroid and bounding box, while rejecting inputs that are not place names. list_archive exposes the current satellite, sensor, and search vocabulary from Bhoonidhi. search_scenes then performs a stateless search over an area and date range; it does not persist results automatically.

A search can be stored with save_query under a reusable slug. list_queries, show_query, and remove_query manage those saved searches. preview_download provides a dry run that identifies scenes a download would fetch and scenes it would skip.

Downloads run as background jobs. download_query immediately returns a job ID for open-access scenes from a saved query. download_status reports transfer details, and download_wait waits for completion or a capped timeout. Cart tools route saved-query scenes according to their availability and can list or remove staged items.

Setup and configuration

Install and launch the server with uvx:

bash
uvx --from git+https://github.com/geovicco-dev/bhoonidhi-mcp bhoonidhi-mcp

The process communicates over stdio and is launched by an MCP client. A local checkout can instead be installed with uv sync, using .venv/bin/bhoonidhi-mcp as the command.

Searches, saved queries, previews, and archive inspection do not require credentials. Downloads and cart actions require a Bhoonidhi login. The documented setup is bhd auth login, which creates a session reused by the server. For headless use, BHOONIDHI_USERNAME and BHOONIDHI_PASSWORD can be provided to establish a session; credentials are not accepted as tool arguments.

Optional settings include BHOONIDHI_MCP_GEOCODER_USER_AGENT, BHOONIDHI_MCP_FUZZY_THRESHOLD, BHOONIDHI_MCP_MAX_RESULTS, and BHOONIDHI_MCP_DOWNLOAD_ROOT. The last setting controls the fixed root used for downloads.

Tools and capabilities

The bhoonidhi-mcp MCP server exposes tools for:

  • Discovering supported satellites, sensors, and search terms.
  • Resolving named places to geographic search bounds.
  • Searching scenes and reporting Ready, Archived, OnOrder, or Priced availability.
  • Saving, listing, inspecting, and deleting reusable queries.
  • Previewing download effects before fetching data.
  • Starting, monitoring, and waiting for background downloads.
  • Adding saved-query scenes to the cart, viewing cart contents, and removing items.
  • Checking whether a Bhoonidhi login is configured without exposing its token.

Limitations and notes

Download jobs live only while the server process is running. For large transfers, the status response recommends using a standalone bhd query download <slug> command that you control. Archived scenes may require a separate request through the Bhoonidhi portal before they become downloadable. The server reports this state rather than treating every open-data scene as immediately ready.

The server does not accept passwords or tokens through its MCP tools, and auth_status does not return authentication secrets. Search results are capped by the configured maximum, which defaults to 50 scenes returned inline.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Bhoonidhi MCP

bhoonidhi-mcp is an MCP server that connects AI agents to ISRO's Bhoonidhi Browse & Order portal. Its main tools discover archive vocabulary, resolve places, search satellite scenes, save queries, preview downloads, manage background downloads, and stage scenes in the cart. Searches need no login; downloads and cart actions do.

Install it with `uvx --from git+https://github.com/geovicco-dev/bhoonidhi-mcp bhoonidhi-mcp`. Configure an MCP client to launch that command over stdio. For local development, clone the repository, run `uv sync`, and use `.venv/bin/bhoonidhi-mcp`.

Only downloads and cart operations require a login. Archive discovery, location resolution, scene searches, previews, and saved-query management work without credentials. Authenticate separately with `bhd auth login`, or provide the documented username and password environment variables for a headless setup.

Call `download_query` with a saved-query slug after configuring authentication. The tool starts a background transfer and returns a job ID. Use `download_status` for progress or `download_wait` to block until completion; only open-access scenes are downloaded.

Yes. `search_scenes` and `preview_download` distinguish Ready, Archived, OnOrder, and Priced scenes. Archived scenes are open data but may need a request through the Bhoonidhi portal before downloading, so they are not treated as immediately available.

Related MCP servers

All in Aerospace & Astrodynamics All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBhoonidhi MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/bhoonidhi-mcp?style=directory)](https://allmcps.com/mcp/bhoonidhi-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/bhoonidhi-mcp"><img src="https://allmcps.com/api/badge/bhoonidhi-mcp?style=directory" alt="Bhoonidhi MCP on AllMCPs" /></a>