MCP Server

Umbra open SAR archive MCP Server

io.github.reesehammer/umbra-mcp

Repository Registry

What is the Umbra open SAR archive MCP server?

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

How to install Umbra open SAR archive

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

UMBRA_CANOPY_TOKEN
secret
Canopy API token. Set it and the same search tools query Umbra's authenticated commercial archive instead of the open bucket; leave it unset for the open data, which needs no credentials.
UMBRA_INDEX_DB
Path to a local catalog index (built with 'umbra index build' or fetched with 'umbra index fetch'). Without one the server walks the public bucket per search, which is correct but slow.
ANTHROPIC_API_KEY
secret
Enables the two opt-in model tools, describe_scene and narrate_change. Every other tool is deterministic and calls no model.
OPENAI_API_KEY
secret
Alternative provider for the same two model tools, and the encoder behind find_similar_text.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "umbra-mcp": {
      "command": "uvx",
      "args": [
        "umbra-py",
        "--from",
        "umbra-py[mcp]",
        "umbra-mcp"
      ],
      "env": {
        "UMBRA_CANOPY_TOKEN": "<YOUR_UMBRA_CANOPY_TOKEN>",
        "UMBRA_INDEX_DB": "<YOUR_UMBRA_INDEX_DB>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
      }
    }
  }
}