io.github.reesehammer/umbra-mcp

up checked 2026-11-11T02:37:38.387Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Umbra open SAR archive

Publisher-provided description

Search, preview, and measure Umbra open SAR from any MCP client. Umbra ships no search API.

Summary by lookupd

Searches an open SAR imagery archive by place, text, or similarity, then previews, downloads, and measures change between satellite passes.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http umbra https://api.umbra-py.space/mcp

Claude Code, pypi package (stdio)

claude mcp add umbra -- uvx umbra-py

Codex, remote (streamable-http)

codex mcp add umbra --url https://api.umbra-py.space/mcp

Codex, pypi package (stdio)

codex mcp add umbra -- uvx umbra-py

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "umbra": {
      "url": "https://api.umbra-py.space/mcp"
    }
  }
}

Cursor, pypi package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "umbra": {
      "command": "uvx",
      "args": [
        "umbra-py"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (19 tools)

Publisher-provided text

• search_catalog Search Umbra's catalog and return compact context cards. Filters (all optional, combine freely): ``bbox`` as ``[min_lon, min_lat, max_lon, max_lat]`` i
• find_repeat_sites Rank sites imaged more than once, before a change tool is pointed at one. Use this when the site is not already known. Each site's ``hrefs`` are that s
• get_item Return the full context card for one item. ``url`` is the JSON URL of an open-data STAC sidecar, a GEC/SICD (or other product) filename such as ``2025-
• geocode_place Resolve a free-text place name to a bounding box via Nominatim. Returns ``{"bbox": [min_lon, min_lat, max_lon, max_lat], "display_name": ...}`` so the
• index_stats Report on the local catalog index, if one has been built or fetched. Lets a long-running agent decide whether searches will be instant (index present)
• quicklook Return a scene's quicklook PNG as an image block. Prefers a baked catalog preview (``preview="auto"``, the default) so a public host can show the radar
• change_composite Composite 2-3 passes of one site into a change image. Pass the STAC URLs of two or three acquisitions of the *same* site in time order. Colors encode c
• timescan Summarize a whole time series into one activity image. Pass the STAC URLs of a site's passes; the timescan encodes per-pixel temporal statistics so bri
• stack_stats Measure how much a site changed across its passes, as numbers. The quantitative counterpart to ``change_composite`` / ``timescan``: those return a pict
• stack_provenance Check whether a site's passes are one measurement, before measuring them. ``stack_stats`` refuses a selection whose rasters were made by *different* ``
• pick_change_interval Scan a site's whole series and name the two passes worth narrating. The deterministic first half of the "watch a site over time" story, and the step th
• download_asset Download one asset of an item to local disk, gated by a size check. SAR products can be multiple GB, so this is a two-step handshake: call it first wit
• watch_site Report only the acquisitions **new** since the last check of this site. SAR's value for monitoring is its cadence, so the natural workflow is *standing
• find_similar Find archived scenes that **look like** the acquisition at ``url``. This is the one search that lives in the pixels, not the metadata: where ``search_c
• find_similar_text Find archived scenes matching a plain-language ``query`` over their imagery. Text-to-scene search: embeds ``query`` ("ships at a berth", "a flooded field")
• describe_scene Return a SAR-literate reading of the scene at ``url``. The picture and the metadata card are produced deterministically; a model only interprets them.
• narrate_change Return a grounded reading of *what changed* between passes. Sibling of :func:`describe_scene`. The composite and the per-block dB grid are produced det
• stamp_description Validate a client-produced scene reading and stamp provenance. This is the interpretation boundary for the no-key kit path: you read the picture ``desc
• stamp_narration Validate a client-produced change narration and stamp provenance. Sibling of :func:`stamp_description` for the no-key ``narrate_change`` kit. Pass the

Details

• Version: 0.1.4
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 408 ms
• First indexed: 2026-11-01T09:51:01.346Z
• Last seen in registry: 2026-11-01T09:51:01.491Z
• Repository: https://github.com/reesehammer/umbra-py

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.reesehammer/umbra-mcp.svg)](https://lookupd.com/servers/io.github.reesehammer/umbra-mcp)

• 62071 servers
• Last crawl: 2026-11-11T16:17:25.167Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp