Skip to content
Eden Engine
Get started

Earth Search Scene Search: Satellite Imagery by Collection, Bounding Box and Date

element84earthsearch/search-scenes

Search one Element 84 Earth Search collection for satellite scenes (STAC items) that intersect a bounding box, newest first: scene id, acquisition time, platform, cloud cover (`eo:cloud_cover`), footprint geometry, and asset links to the band files and thumbnails. Give the collection id, a bounding box as west,south,east,north in degrees (lon,lat), optionally a date or date interval (RFC 3339, for example 2026-09-01T00:00:00Z/2026-10-01T00:00:00Z), and how many scenes to return (1 to 10, default 5). An empty `features` list means no scene matches. Each scene is about 20 KB. Passed through unmodified and served by Eden Engine; not an official Element 84 product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Element 84 Earth Search (STAC API on AWS Open Data)

Satellite catalogue from Earth Search by Element 84 (STAC API over AWS Open Data), passed through unmodified. Sentinel data: contains modified Copernicus Sentinel data, credit Copernicus and ESA; each collection's own licence link in its record controls reuse. Served by Eden Engine; not an official Element 84 product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install itCreate an account
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "element84earthsearch/search-scenes" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "element84earthsearch/search-scenes" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "element84earthsearch/search-scenes", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "element84earthsearch/search-scenes", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 21, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "collection",
    "bbox"
  ],
  "properties": {
    "bbox": {
      "type": "string",
      "pattern": "^-?[0-9]+(\\.[0-9]+)?(,-?[0-9]+(\\.[0-9]+)?){3}$",
      "description": "Bounding box as west,south,east,north in decimal degrees (longitude,latitude order), for example -122.5,37.7,-122.3,37.9."
    },
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 10,
      "minimum": 1,
      "description": "How many scenes to return, 1 to 10; defaults to 5."
    },
    "datetime": {
      "type": "string",
      "pattern": "^(?:[0-9]{4}-[0-9]{2}-[0-9]{2}(?:[Tt][0-9:.]+(?:[Zz]|[+-][0-9:]+)?)?|\\.\\.)(/(?:[0-9]{4}-[0-9]{2}-[0-9]{2}(?:[Tt][0-9:.]+(?:[Zz]|[+-][0-9:]+)?)?|\\.\\.))?$",
      "description": "Optional RFC 3339 date-time or interval start/end (use .. for an open end), for example 2026-09-01T00:00:00Z/2026-10-01T00:00:00Z."
    },
    "collection": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
      "description": "The collection to search, a collection id from the collections tool, for example sentinel-2-l2a."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "features"
  ],
  "properties": {
    "type": {
      "type": "string"
    },
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "context": {
      "type": "object",
      "additionalProperties": true
    },
    "features": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The scene id."
          },
          "bbox": {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "assets": {
            "type": "object",
            "description": "Named asset links (bands, thumbnails, metadata), each with an `href`.",
            "additionalProperties": true
          },
          "geometry": {
            "type": "object",
            "additionalProperties": true
          },
          "collection": {
            "type": "string"
          },
          "properties": {
            "type": "object",
            "description": "Acquisition time (`datetime`), platform, `eo:cloud_cover` and collection-specific fields.",
            "additionalProperties": true
          }
        },
        "description": "One STAC item: a satellite scene or image tile.",
        "additionalProperties": true
      }
    },
    "numberMatched": {
      "type": "integer",
      "description": "How many scenes match in total."
    },
    "numberReturned": {
      "type": "integer"
    }
  },
  "description": "A GeoJSON FeatureCollection of STAC items, newest acquisition first.",
  "additionalProperties": true
}