@pipeworx/earth-search
Connect: https://gateway.pipeworx.io/earth-search/mcp · Install: one-click buttons
No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.
Tools: 3
Sentinel and Landsat imagery catalogue from Element 84’s Earth Search over the AWS Open Data registry — search Sentinel-1/2, Landsat Collection 2, NAIP and Copernicus DEM by area and date and get item ids, footprints, cloud cover and cloud-optimised GeoTIFF URLs.
Tools
earth_search_collections(contains?, prefix?, limit?)— the missions indexed, with licence, extent and date range.earth_search_collection(collection_id)— one collection in full, including the asset keys (bands, thumbnails) its items carry.earth_search_search(collections?, bbox?, datetime?, ids?, limit?, max_assets?)— which scenes cover an area on given dates.collectionsis optional here, unlike the sibling catalogues.
Auth
Keyless, metadata and assets. Hrefs resolve on AWS Open Data with no token and
no account — this is the catalogue to send a caller to when they need bytes
rather than metadata. Some buckets are requester-pays when read over s3://
rather than https://.
Data sources
- https://earth-search.aws.element84.com/v1 — STAC API 1.0.
Shared client: shared/src/stac.ts, also used by planetary-computer,
copernicus-dataspace and meteoswiss.
Traps
- This is the one catalogue in the set that allows a catalogue-wide search.
Planetary Computer (422) and the Copernicus Data Space (400) both refuse a
search with no
collections. Useful for “is there ANY imagery here” — but the result then spans missions with very different resolutions, so readcollectionon each item before comparing them. - Collection ids are not portable. Sentinel-2 L2A is
sentinel-2-c1-l2ahere (Collection 1 reprocessing) andsentinel-2-pre-c1-l2afor the older baseline, while the same mission issentinel-2-l2aon Planetary Computer and on the Copernicus Data Space. The wrong id returns an empty result, not an error.
Tools
- earth_search_collections — List the satellite collections indexed by Element 84’s Earth Search over AWS Open Data — Sentinel-1 GRD, Sentinel-2 L1C/L2A, Landsat Collection 2, NAIP, Copernicus DEM — with each one’s licence, exten
- earth_search_collection — Full detail for one Earth Search collection: title, description, licence, providers, spatial and temporal extent, and the asset keys (bands, thumbnails, metadata) its items carry. AUTHORITATIVE for wh
- earth_search_search — Search free Sentinel, Landsat and NAIP imagery by area and date, returning item ids, acquisition datetimes, footprints, cloud cover and public GeoTIFF URLs that download with no account. AUTHORITATIVE
Tools
earth_search_collection— Full detail for one Earth Search collection: title, description, licence, providers, spatial and temporal extent, and the asset keys (bands, thumbnails, metadata) its items carry. AUTHORITATIVE for whearth_search_collections— List the satellite collections indexed by Element 84's Earth Search over AWS Open Data — Sentinel-1 GRD, Sentinel-2 L1C/L2A, Landsat Collection 2, NAIP, Copernicus DEM — with each one's licence, extenearth_search_search— Search free Sentinel, Landsat and NAIP imagery by area and date, returning item ids, acquisition datetimes, footprints, cloud cover and public GeoTIFF URLs that download with no account. AUTHORITATIVE