`earth_search_search`

Pack: earth-search · Endpoint: https://gateway.pipeworx.io/earth-search/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/earth_search_search for the schema, then POST the same URL with its arguments for the data.

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 for ‘what open satellite imagery covers this place on these dates’ — it queries the live index. Unlike the Planetary Computer and Copernicus Data Space catalogues, collections is OPTIONAL here, so you can sweep every mission at once. bbox is WGS84 degrees, [west, south, east, north].

Parameters

Name	Type	Required	Description
`collections`	array	no	Collection ids to restrict to, e.g. [“sentinel-2-c1-l2a”]. Optional — omit to search every mission at once. List ids with earth_search_collections.
`items`	string	no
`bbox`	array	no	Bounding box in WGS84 degrees as [west, south, east, north], e.g. [-122.6, 37.6, -122.3, 37.9] for San Francisco. Longitude first.
`items`	number	no
`datetime`	string	no	RFC 3339 instant or interval, e.g. “2026-06-01T00:00:00Z/2026-07-01T00:00:00Z” or “2026-06-01T00:00:00Z/..”. Omit for any date.
`ids`	array	no	Fetch specific item ids instead of searching by area/date.
`items`	string	no
`limit`	number	no	Items to return, 1-100. Default 10.
`max_assets`	number	no	Asset entries per item, 1-50. Default 8 — a Sentinel-2 item carries ~30 assets and returning all of them for 100 items is a very large payload.

Example call

Arguments

{
  "collections": [
    "sentinel-2-c1-l2a"
  ],
  "bbox": [
    -122.6,
    37.6,
    -122.3,
    37.9
  ],
  "datetime": "2026-06-01T00:00:00Z/2026-07-01T00:00:00Z",
  "limit": 3,
  "max_assets": 4
}

curl

curl -X POST https://gateway.pipeworx.io/earth-search/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"earth_search_search","arguments":{"collections":["sentinel-2-c1-l2a"],"bbox":[-122.6,37.6,-122.3,37.9],"datetime":"2026-06-01T00:00:00Z/2026-07-01T00:00:00Z","limit":3,"max_assets":4}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('earth_search_search', {
  "collections": [
    "sentinel-2-c1-l2a"
  ],
  "bbox": [
    -122.6,
    37.6,
    -122.3,
    37.9
  ],
  "datetime": "2026-06-01T00:00:00Z/2026-07-01T00:00:00Z",
  "limit": 3,
  "max_assets": 4
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "earth-search": {
      "url": "https://gateway.pipeworx.io/earth-search/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

earth_search_search