STAC

STAC

STAC catalog and item search MCP server for rapid geospatial data discovery.

6
Stars
1
Forks
13
Releases

Overview

STAC MCP Server provides access to STAC APIs for geospatial data discovery and access. It exposes a set of MCP tools that enable AI assistants and applications to interact with STAC catalogs: search and browse collections, retrieve metadata, and perform spatial and temporal queries. The server implements core tools including get_root, get_conformance, search_collections, get_collection, search_items, get_item, and estimate_data_size. Each tool supports an optional output_format parameter, defaulting to text, with JSON mode returning a compact envelope: { "mode": "json", "data": { ... } } to enable structured consumption (as per ADR 0006 and ASR 1003). The system also supports capability discovery and aggregations (ADR 0004) with graceful fallbacks when endpoints are missing, and describes how conformance and queryables behave in those scenarios. Data Size Estimation uses odc.stac to lazily load items into xarray datasets, clips AOI to the smallest common area when both bbox and AOI are provided, and returns detailed metadata about variables, coordinates, and assets. The MCP server can be run via Docker/Container and adheres to the MCP transport via stdio.

Details

Owner
Wayfinder-Foundry
Language
Python
License
MIT License
Updated
2025-12-07

Features

get_root

Fetch root document (id/title/description/links/conformance subset) to provide overview and capability context.

get_conformance

List all conformance classes; optionally verify specific URIs.

search_collections

List and search available STAC collections.

get_collection

Get detailed information about a specific collection.

search_items

Search for STAC items with spatial, temporal, and attribute filters.

get_item

Get detailed information about a specific STAC item.

estimate_data_size

Estimate data size for STAC items using lazy loading (XArray + odc.stac); supports AOI clipping and returns detailed metadata.

capability discovery & aggregations

Capability discovery and aggregation support (ADR 0004): graceful fallbacks for missing endpoints; get_conformance fallback to root; get_queryables may return empty with message; get_aggregations uses STAC search with aggregations and reports descriptive messages if unsupported.

Audience

AI assistantsInteract with STAC catalogs to search collections, items, and metadata via MCP.
ApplicationsIntegrate STAC data discovery into workflows via the MCP protocol.

Tags

STACMCPSTAC-APIgeospatialdata discoverysearch_collectionssearch_itemsget_collectionget_itemget_rootconformanceaggregationsqueryablesodc-stacxarrayAOI clippingdual outputJSON envelope