get_granules

io.github.nasa/earthdata-mcp · Verify this server

Search NASA CMR granules for a specific parent collection and return up to 10 lightweight normalized results. Key return fields in each item: - concept_id: CMR granule concept ID - native_id: native ID of the granule record - revision_id: revision ID of the granule metadata - provider_id: provider ID of the granule - granule_ur: primary granule identifier - time_start / time_end: temporal coverage bounds - access_urls: actionable data access URLs - cloud_cover: cloud cover percentage - day_night_flag: DAY, NIGHT, BOTH, or UNSPECIFIED - size_mb: file size in megabytes - data_format: file format (e.g., NetCDF-4, GeoTIFF) - bounding_box: [West, South, East, North] Minimum Bounding Rectangle (MBR) footprint. Note: for swath data or irregular polygons, this bounding box fully encloses the data but may contain empty space at the corners. IMPORTANT — data availability checks: Without temporal and/or spatial filters, results represent ALL granules ever archived in the collection, which may span decades and the entire globe. total_hits without filters tells you the full archive size, NOT whether data exists for a specific area or time period. To verify availability for a specific region and/or period, apply the corresponding spatial or temporal filters. Single-filter queries (e.g., temporal-only) are completely valid and should be used when the user only specifies one constraint, but combining both provides the most precise availability answer. Key parameters: - collection_concept_id: required parent collection concept ID - temporal_start_date / temporal_end_date: filter to granules overlapping this time window — always set when the user specifies a time period - spatial_wkt_geometry: filter to granules intersecting this area — always set when the user specifies a geographic region - cloud_cover_min / cloud_cover_max: filter optical imagery by cloud cover percentage (0–100). Only set for optical/visible imagery collections (Landsat, MODIS, VIIRS, Sentinel-2 via CMR). Do NOT set for non-optical data (SAR, altimetry, model output, etc.) Iteration & Refinement: - Results are strictly capped at 10 items to optimize context window usage. - If total_hits exceeds 10 and you lack the necessary results, do not attempt to page. Refine your query by adding tighter spatial or temporal constraints. Tips: - For the most precise availability check, provide both temporal and spatial filters if the user specifies both; otherwise, apply whichever constraint they provided - total_hits in the response reflects the filtered count — zero means no data for that combination - When users ask for "clear" or "cloud-free" imagery, set cloud_cover_max to a low value (e.g., 10 or 20)