NASA Earthdata MCP

Discover, verify, and access NASA Earth science datasets via the Common Metadata Repository (CMR)

我該用這個嗎

品質與安全性

A
說明品質
100%
結構描述完整度
67%
命名品質
100%
汙染風險
100%
權限相符程度
100%
協定合規性
100%

根據工具定義與協定合規性的自動化分析。

上下文成本

~11,220Token(工具定義)
~16.7 KB典型回應大小
顯著的注意力影響(128k 上下文的 8.77%)

這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。

安裝

一鍵安裝

將以下內容加入你的 `claude_desktop_config.json` 檔案:

{
  "mcpServers": {
    "earthdata-mcp": {
      "url": "https://cmr.earthdata.nasa.gov/mcp/v1"
    }
  }
}

遠端端點

https://cmr.earthdata.nasa.gov/mcp/v1streamable-http

它能做什麼

工具清單

工具(7)

🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢get_citations(collection_concept_id, identifier, provider, limit, cursor, ...)

Discover citation records directly associated with a collection, or look up a citation by identifier (e.g. DOI). Use this tool to evaluate citation relevance for a collection. Key fields in each returned item: - concept_id: CMR citation concept ID - name: The title or name of the citation - identifier: The primary DOI or identifier - abstract: Abstract text - citation_metadata: Nested metadata including Year, Publisher, and Author list

輸入結構描述

{
  "type": "object",
  "properties": {
    "collection_concept_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "identifier": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "provider": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50). Keep this small to avoid context window bloat. When using limit > 10, always specify the fields parameter.",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results. Pass the exact next_cursor string returned by the previous tool call. Cursors are query-scoped: they lock in the original search parameters and cannot be reused across different tools or different queries. If you need to change any search parameter, start a new search without a cursor."
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Status of the tool execution",
      "enum": [
        "success",
        "no_results",
        "error"
      ],
      "title": "SearchStatus",
      "type": "string"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Error details when status is error",
      "title": "Error Message"
    },
    "total_hits": {
      "default": 0,
      "description": "Total number of matching items",
      "title": "Total Hits",
      "type": "integer"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page; None when no more results",
      "title": "Next Cursor"
    },
    "citations": {
      "description": "Normalized citation results mapped from UMM-Citations",
      "items": {
        "description": "Normalized citation result for direct CMR-backed retrieval.",
        "properties": {
          "abstract": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The abstract of the citation",
            "title": "Abstract"
          },
          "associated_collections": {
            "description": "CMR concept IDs of NASA datasets (collections) associated with this citation. CRITICAL: Pass these IDs to the get_collections tool to retrieve the human-readable dataset details.",
            "items": {
              "type": "string"
            },
            "title": "Associated Collections",
            "type": "array"
          },
          "citation_metadata": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Rich citation metadata including authors, publisher, year, and title",
            "title": "Citation Metadata"
          },
          "concept_id": {
            "description": "CMR citation concept ID",
            "title": "Concept Id",
            "type": "string"
          },
          "identifier": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The primary identifier (e.g., DOI)",
            "title": "Identifier"
          },
          "identifier_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Type of the identifier (e.g., DOI)",
            "title": "Identifier Type"
          },
          "metadata_specification": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Schema version of the citation metadata",
            "title": "Metadata Specification"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The name or title of the citation",
            "title": "Name"
          },
          "native_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The native ID of the citation record",
            "title": "Native Id"
          },
          "provider_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The provider ID of the citation",
            "title": "Provider Id"
          },
          "related_identifiers": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Identifiers of related works",
            "title": "Related Identifiers"
          },
          "resolution_authority": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Authority to resolve the identifier (e.g., https://doi.org)",
            "title": "Resolution Authority"
          },
          "revision_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The revision ID of the citation metadata",
            "title": "Revision Id"
          }
        },
        "required": [
          "concept_id"
        ],
        "title": "CitationResult",
        "type": "object"
      },
      "title": "Citations",
      "type": "array"
    }
  },
  "required": [
    "status"
  ],
  "description": "Output model for get_citations.",
  "title": "GetCitationsOutput"
}
🟢get_collections(keyword, concept_id, short_name, provider, temporal_start_date, ...)

Search NASA CMR collections and return up to 10 lightweight normalized results. Key return fields in each item: - concept_id: CMR collection concept ID - native_id: native ID of the collection record - revision_id: revision ID of the collection metadata - provider_id: provider ID of the collection - short_name: collection short name - entry_title: collection title - time_start / time_end: temporal coverage bounds - processing_level_id: processing level (e.g., L3, L4) - doi: digital object identifier - collection_data_type: data type (e.g., SCIENCE_QUALITY, NEAR_REAL_TIME) - temporal_resolution / spatial_resolution: extracted resolution strings - related_urls: links to landing pages, documentation, and tools Unfiltered searches are supported when you need broad exploration. IMPORTANT — relevance and coverage: A keyword-only search returns all collections whose metadata mentions those terms, regardless of whether they actually hold data for the user's region or time period. Collection declared extents are often global or multi-decadal, so a collection appearing in results does not mean it has granules for a specific area or date. When the user's question involves a time period or geographic region, include temporal_start_date/temporal_end_date and/or spatial_wkt_geometry to restrict results to collections that overlap that window. Follow up with get_granules (with the same filters) to confirm actual data availability. IMPORTANT — keyword AND logic: CMR treats each space-separated keyword as an independent term and requires ALL of them to appear somewhere in a collection's metadata (title, summary, science keywords, instruments, platforms, etc.). Words do not need to appear in the same field or adjacent to each other. Because every term must match, adding more words makes the search STRICTER, not broader — the opposite of typical web search engines. Prefer 2–4 precise scientific terms. If a search returns 0 results, try removing the least essential word before broadening other filters. Phrase search (exact word sequence) is available by wrapping the value in escaped double quotes, but you cannot mix a phrase with additional standalone keywords. Key parameters: - keyword: free-text keyword search over collection metadata (AND logic; see above) - concept_id: exact collection concept ID - short_name: collection short name - provider: data provider short name - temporal_start_date / temporal_end_date: restrict to collections whose declared range overlaps this window; set when the user specifies a time period - spatial_wkt_geometry: restrict to collections whose declared extent intersects this area; set when the user specifies a geographic region 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 search by adding tighter spatial, temporal, or keyword constraints. Tips: - Use scientific terms (variables, instruments, platforms) for better keyword relevance - Keep keyword queries to 2–4 precise terms; more words = stricter filter - If 0 results, drop the least essential keyword and retry before broadening other filters - Combine keyword + temporal + spatial filters for highest precision - Use short_name when you already know the target product

輸入結構描述

{
  "type": "object",
  "properties": {
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Free-text keyword search. Case insensitive. IMPORTANT — CMR uses AND logic: each space-separated word is matched independently and ALL words must appear somewhere in a collection's indexed fields (title, summary, short name, GCMD science keywords, platform and instrument names, project names, processing level, archive centers, additional attributes, etc.). Words do NOT need to appear in the same field or as a contiguous phrase. Because every word must match, adding more words makes the search STRICTER, not broader — the opposite of typical web search engines. Prefer 2–4 precise terms over long queries. Example: 'soil moisture' (2 terms, broad) vs 'soil moisture SMAP L3' (4 terms, narrow). Phrase search: wrap the entire value in escaped double quotes to require an exact phrase (e.g., '\\\"sea surface temperature\\\"'). Only a single phrase is supported; you cannot mix a phrase with additional standalone words. Wildcards supported: * (zero or more chars), ? (any single char). Use scientific terms: geophysical variable names ('sea surface temperature', 'soil moisture'), instrument names (MODIS, ASCAT, VIIRS, AIRS, Landsat, etc.), or platform names (Terra, Aqua, SMAP, Sentinel-1, etc.). For known product short names use the short_name parameter instead."
    },
    "concept_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Exact CMR concept ID (format: C<number>-<PROVIDER>, e.g., C2036882064-POCLOUD). Use for direct lookup of a known collection."
    },
    "short_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Collection short name (e.g., MOD11A1, SPL3SMP, MUR-JPL-L4-GLOB-v4.1). Exact match by default; wildcards * and ? are supported."
    },
    "provider": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Data provider short name (e.g., PODAAC, NSIDC_ECS, GES_DISC, ORNL_DAAC, LAADS, GHRC_DAAC, ASDC). Restricts results to collections from that provider. WARNING: NASA DAACs are actively migrating assets to the cloud under new provider IDs (e.g., LPDAAC_ECS → LPCLOUD, PODAAC → POCLOUD). If you know the exact short_name of a product, do NOT include the provider parameter — a stale provider ID will silently return 0 results. Use provider only when the user explicitly filters by archive center."
    },
    "temporal_start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Start of temporal filter in ISO 8601 format (e.g., 2020-01-01T00:00:00Z). Restricts results to collections whose declared temporal range overlaps this window. Set this whenever the user specifies a time period — omitting it returns collections regardless of when their data was collected."
    },
    "temporal_end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "End of temporal filter in ISO 8601 format (e.g., 2020-12-31T23:59:59Z). Restricts results to collections whose declared temporal range overlaps this window. Set this whenever the user specifies a time period — omitting it returns collections regardless of when their data was collected."
    },
    "spatial_wkt_geometry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Spatial filter as WKT geometry. Supported types: POLYGON((lon lat, ...)), POINT(lon lat), or LINESTRING(lon lat, ...).Restricts results to collections whose declared extent intersects this area. CMR returns any collection that touches this shape, so precise geometries are preferred to prevent false positives. Set this whenever the user specifies a geographic region — omitting it returns collections with global or unspecified coverage."
    },
    "platform": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "instrument": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "processing_level_id": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "has_granules": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "When True, filters to collections that have actual granule data. Prevents returning metadata-only shells."
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50). Keep this small to avoid context window bloat. When using limit > 10, always specify the fields parameter.",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results. Pass the exact next_cursor string returned by the previous tool call. Cursors are query-scoped: they lock in the original search parameters and cannot be reused across different tools or different queries. If you need to change any search parameter, start a new search without a cursor."
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Status of the tool execution",
      "enum": [
        "success",
        "no_results",
        "error"
      ],
      "title": "SearchStatus",
      "type": "string"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Error details when status is error",
      "title": "Error Message"
    },
    "total_hits": {
      "default": 0,
      "description": "Total number of matching items",
      "title": "Total Hits",
      "type": "integer"
    },
    "collections": {
      "description": "Normalized collection results mapped from UMM-C",
      "items": {
        "description": "Minimal collection result for direct CMR-backed discovery.",
        "properties": {
          "abstract": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Collection summary or abstract",
            "title": "Abstract"
          },
          "archive_and_distribution_information": {
            "description": "File formats and media types (e.g., [{format, media_type}])",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Archive And Distribution Information",
            "type": "array"
          },
          "bounding_box": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "[West, South, East, North] Minimum Bounding Rectangle",
            "title": "Bounding Box"
          },
          "collection_data_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "e.g., SCIENCE_QUALITY, NEAR_REAL_TIME",
            "title": "Collection Data Type"
          },
          "collection_progress": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "ACTIVE, COMPLETE, DEPRECATED, or PLANNED",
            "title": "Collection Progress"
          },
          "concept_id": {
            "description": "CMR collection concept ID",
            "title": "Concept Id",
            "type": "string"
          },
          "data_centers": {
            "description": "Archiving DAACs — array of {role, short_name}",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Data Centers",
            "type": "array"
          },
          "doi": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Digital Object Identifier",
            "title": "Doi"
          },
          "entry_title": {
            "description": "Collection title",
            "title": "Entry Title",
            "type": "string"
          },
          "instruments": {
            "description": "Instrument short names",
            "items": {
              "type": "string"
            },
            "title": "Instruments",
            "type": "array"
          },
          "is_ongoing": {
            "default": false,
            "description": "Whether the collection is ongoing",
            "title": "Is Ongoing",
            "type": "boolean"
          },
          "native_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The native ID of the collection record",
            "title": "Native Id"
          },
          "platforms": {
            "description": "Platform short names",
            "items": {
              "type": "string"
            },
            "title": "Platforms",
            "type": "array"
          },
          "processing_level_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Processing level (e.g., L3, L4)",
            "title": "Processing Level Id"
          },
          "provider_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The provider ID of the collection",
            "title": "Provider Id"
          },
          "related_urls": {
            "description": "List of related URLs (e.g., documentation, guides)",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Related Urls",
            "type": "array"
          },
          "revision_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The revision ID of the collection metadata",
            "title": "Revision Id"
          },
          "science_keywords": {
            "description": "GCMD science keyword hierarchy (Category/Topic/Term/VariableLevel)",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Science Keywords",
            "type": "array"
          },
          "short_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Collection short name",
            "title": "Short Name"
          },
          "spatial_resolution": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Human-readable spatial resolution",
            "title": "Spatial Resolution"
          },
          "temporal_resolution": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Human-readable temporal resolution",
            "title": "Temporal Resolution"
          },
          "time_end": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "End of temporal coverage",
            "title": "Time End"
          },
          "time_start": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Start of temporal coverage",
            "title": "Time Start"
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Collection version",
            "title": "Version"
          }
        },
        "required": [
          "concept_id",
          "entry_title"
        ],
        "title": "CollectionResult",
        "type": "object"
      },
      "title": "Collections",
      "type": "array"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results",
      "title": "Next Cursor"
    }
  },
  "required": [
    "status"
  ],
  "description": "Output model for get_collections.",
  "title": "GetCollectionsOutput"
}
🟢get_granules(collection_concept_id, temporal_start_date, temporal_end_date, spatial_wkt_geometry, cloud_cover_min, ...)

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)

輸入結構描述

{
  "type": "object",
  "properties": {
    "collection_concept_id": {
      "description": "Parent collection concept ID (format: C<number>-<PROVIDER>, e.g., C2723758340-GES_DISC). Required to scope granule search.",
      "type": "string"
    },
    "temporal_start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Start of temporal filter in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Finds granules whose temporal extent overlaps this window. Set this whenever the user specifies a time period — omitting it returns granules from the entire collection archive regardless of date."
    },
    "temporal_end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "End of temporal filter in ISO 8601 format (e.g., 2024-01-31T23:59:59Z). Finds granules whose temporal extent overlaps this window. Set this whenever the user specifies a time period — omitting it returns granules from the entire collection archive regardless of date."
    },
    "spatial_wkt_geometry": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Spatial filter as WKT geometry. Supported types: POLYGON((lon lat, ...)), POINT(lon lat), or LINESTRING(lon lat, ...).Finds granules with spatial extent intersecting this area. CMR returns any granule that touches this shape, so precise geometries are preferred to prevent false positives. Set this whenever the user specifies a geographic region — omitting it returns granules from the entire globe regardless of location."
    },
    "cloud_cover_min": {
      "anyOf": [
        {
          "maximum": 100,
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Minimum cloud cover percentage (0–100, inclusive). Use with cloud_cover_max to filter optical/visible imagery granules by cloud cover. Only applicable to collections that report cloud cover (e.g., Landsat, MODIS, etc). Omit for non-optical data (SAR, altimetry, etc.)."
    },
    "cloud_cover_max": {
      "anyOf": [
        {
          "maximum": 100,
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Maximum cloud cover percentage (0–100, inclusive). Use with cloud_cover_min to filter optical/visible imagery granules by cloud cover. For example, set cloud_cover_max=20 to find mostly clear scenes. Only applicable to collections that report cloud cover (e.g., Landsat, MODIS, etc). Omit for non-optical data (SAR, altimetry, etc.)."
    },
    "day_night_flag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter granules by day/night acquisition flag. Values: 'DAY', 'NIGHT', 'UNSPECIFIED'."
    },
    "sort_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Sort key for granule results. e.g., '-start_date' (newest first), 'start_date' (oldest first). CMR default is relevance score. For ongoing or near-real-time (NRT) missions where the user wants the most recent data, always use '-start_date' — CMR's default relevance scoring may return historical data first if sort_key is not explicitly set."
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50). Keep this small to avoid context window bloat. When using limit > 10, always specify the fields parameter.",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results. Pass the exact next_cursor string returned by the previous tool call. Cursors are query-scoped: they lock in the original search parameters and cannot be reused across different tools or different queries. If you need to change any search parameter, start a new search without a cursor."
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "collection_concept_id"
  ],
  "additionalProperties": false
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Status of the tool execution",
      "enum": [
        "success",
        "no_results",
        "error"
      ],
      "title": "SearchStatus",
      "type": "string"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Error details when status is error",
      "title": "Error Message"
    },
    "total_hits": {
      "default": 0,
      "description": "Total number of matching items",
      "title": "Total Hits",
      "type": "integer"
    },
    "granules": {
      "description": "Normalized granule results mapped from UMM-G",
      "items": {
        "description": "Minimal granule result for direct CMR-backed retrieval.",
        "properties": {
          "access_urls": {
            "description": "Actionable data access URLs (Note: Access requires Earthdata Login authentication)",
            "items": {
              "type": "string"
            },
            "title": "Access Urls",
            "type": "array"
          },
          "additional_attributes": {
            "description": "Provider-specific attributes (e.g., tile coords, quality flags) — array of {name, values[]}",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Additional Attributes",
            "type": "array"
          },
          "bounding_box": {
            "anyOf": [
              {
                "items": {
                  "type": "number"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "[West, South, East, North] Minimum Bounding Rectangle (MBR). Note: For swath data or irregular polygons, this bounding box fully encloses the data but may contain empty space at the corners.",
            "title": "Bounding Box"
          },
          "cloud_cover": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Cloud cover percentage",
            "title": "Cloud Cover"
          },
          "collection_concept_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Parent collection concept ID",
            "title": "Collection Concept Id"
          },
          "concept_id": {
            "description": "CMR granule concept ID",
            "title": "Concept Id",
            "type": "string"
          },
          "data_format": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "File format (e.g., NetCDF-4, GeoTIFF)",
            "title": "Data Format"
          },
          "day_night_flag": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "DAY, NIGHT, BOTH, or UNSPECIFIED",
            "title": "Day Night Flag"
          },
          "granule_ur": {
            "description": "Granule UR",
            "title": "Granule Ur",
            "type": "string"
          },
          "native_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The native ID of the granule record",
            "title": "Native Id"
          },
          "orbit_info": {
            "description": "Orbit calculated spatial domains — array of {orbit_number, equator_crossing_longitude, equator_crossing_date_time}",
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Orbit Info",
            "type": "array"
          },
          "producer_granule_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Producer granule ID",
            "title": "Producer Granule Id"
          },
          "production_date": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Date the granule was generated (ProductionDateTime)",
            "title": "Production Date"
          },
          "provider_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The provider ID of the granule",
            "title": "Provider Id"
          },
          "revision_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The revision ID of the granule metadata",
            "title": "Revision Id"
          },
          "size_mb": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Size of the data granule in MB",
            "title": "Size Mb"
          },
          "time_end": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Granule temporal end",
            "title": "Time End"
          },
          "time_start": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Granule temporal start",
            "title": "Time Start"
          }
        },
        "required": [
          "concept_id",
          "granule_ur"
        ],
        "title": "GranuleResult",
        "type": "object"
      },
      "title": "Granules",
      "type": "array"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results",
      "title": "Next Cursor"
    }
  },
  "required": [
    "status"
  ],
  "description": "Output model for get_granules.",
  "title": "GetGranulesOutput"
}
🟢get_keywords(query, scheme, limit, cursor, fields)

Discover official Earthdata vocabulary (like 'ATMOSPHERIC WATER VAPOR') directly from NASA's Keyword Management System (KMS). Use this to find the exact preferred labels to construct successful get_collections searches. Key fields in each returned item: - prefLabel: The preferred label to use in searches - uuid: The KMS concept UUID - definition: Context and expanded acronyms - scheme: The vocabulary scheme (e.g. sciencekeywords, platforms)

輸入結構描述

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "scheme": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50). Keep this small to avoid context window bloat. When using limit > 10, always specify the fields parameter.",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results. Pass the exact next_cursor string returned by the previous tool call. Cursors are query-scoped: they lock in the original search parameters and cannot be reused across different tools or different queries. If you need to change any search parameter, start a new search without a cursor."
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Status of the tool execution",
      "enum": [
        "success",
        "no_results",
        "error"
      ],
      "title": "SearchStatus",
      "type": "string"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Error details when status is error",
      "title": "Error Message"
    },
    "total_hits": {
      "default": 0,
      "description": "Total number of matching items",
      "title": "Total Hits",
      "type": "integer"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page; None when no more results",
      "title": "Next Cursor"
    },
    "keywords": {
      "description": "List of matched KMS terms",
      "items": {
        "description": "A single matching KMS keyword result.",
        "properties": {
          "uuid": {
            "description": "The unique UUID of the KMS concept",
            "title": "Uuid",
            "type": "string"
          },
          "prefLabel": {
            "description": "The preferred label of the KMS concept",
            "title": "Preflabel",
            "type": "string"
          },
          "scheme": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "The scheme the concept belongs to",
            "title": "Scheme",
            "type": "object"
          },
          "definition": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The primary definition of the concept, if available",
            "title": "Definition"
          }
        },
        "required": [
          "uuid",
          "prefLabel",
          "scheme"
        ],
        "title": "KeywordResult",
        "type": "object"
      },
      "title": "Keywords",
      "type": "array"
    }
  },
  "required": [
    "status"
  ],
  "description": "Output model for get_keywords.",
  "title": "GetKeywordsOutput"
}
🟢get_services(collection_concept_id, keyword, type, limit, cursor, ...)

Search NASA CMR services for a specific parent collection and return all associated normalized UMM-S records. Key fields in each returned item: - concept_id: CMR service concept ID - native_id: native ID of the service record - revision_id: revision ID of the service metadata - provider_id: provider ID of the service - name: service name - type: service type (e.g., OPeNDAP, WCS, Harmony, WMS, WMTS, ESI, EGI - No Processing) - version: service version string - description: human-readable service description - url: Primary endpoint URL information - service_options: supported output formats, projections, subset types, and interpolation methods - operation_metadata: operation names (e.g., GetCapabilities, GetMap) and distributed computing platform Key parameters: - collection_concept_id: required parent collection concept ID Iteration & Refinement: - All services associated with the collection are fetched in a single request. Paging is not supported. Note: A collection may be associated with multiple services of different types. Check type to distinguish between data access services (e.g., OPeNDAP, WCS) and discovery/visualization services (e.g., WMS, WMTS).

輸入結構描述

{
  "type": "object",
  "properties": {
    "collection_concept_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50). Keep this small to avoid context window bloat. When using limit > 10, always specify the fields parameter.",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results. Pass the exact next_cursor string returned by the previous tool call. Cursors are query-scoped: they lock in the original search parameters and cannot be reused across different tools or different queries. If you need to change any search parameter, start a new search without a cursor."
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Status of the tool execution",
      "enum": [
        "success",
        "no_results",
        "error"
      ],
      "title": "SearchStatus",
      "type": "string"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Error details when status is error",
      "title": "Error Message"
    },
    "total_hits": {
      "default": 0,
      "description": "Total number of matching items",
      "title": "Total Hits",
      "type": "integer"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page",
      "title": "Next Cursor"
    },
    "services": {
      "description": "Normalized service results mapped from UMM-S",
      "items": {
        "description": "Minimal service result for direct CMR-backed retrieval.",
        "properties": {
          "access_constraints": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Authentication or authorization requirements",
            "title": "Access Constraints"
          },
          "concept_id": {
            "description": "CMR service concept ID",
            "title": "Concept Id",
            "type": "string"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "A brief description of the service",
            "title": "Description"
          },
          "long_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The long name of the service",
            "title": "Long Name"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The name of the service",
            "title": "Name"
          },
          "native_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The native ID of the service record",
            "title": "Native Id"
          },
          "operation_metadata": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Operation names and distributed computing platform",
            "title": "Operation Metadata"
          },
          "provider_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The provider ID of the service",
            "title": "Provider Id"
          },
          "related_urls": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Documentation, guides, or other related links",
            "title": "Related Urls"
          },
          "revision_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The revision ID of the service metadata",
            "title": "Revision Id"
          },
          "service_keywords": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Controlled vocabulary for service capability",
            "title": "Service Keywords"
          },
          "service_options": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Subset types, supported projections, output formats",
            "title": "Service Options"
          },
          "service_organizations": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Organizations that run the service endpoint",
            "title": "Service Organizations"
          },
          "type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The type of the service",
            "title": "Type"
          },
          "url": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Primary endpoint URL information",
            "title": "Url"
          },
          "use_constraints": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Legal restrictions or usage limits",
            "title": "Use Constraints"
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The edition or version of the service",
            "title": "Version"
          }
        },
        "required": [
          "concept_id"
        ],
        "title": "ServiceResult",
        "type": "object"
      },
      "title": "Services",
      "type": "array"
    }
  },
  "required": [
    "status"
  ],
  "description": "Output model for get_services.",
  "title": "GetServicesOutput"
}
🟢get_tools(collection_concept_id, keyword, limit, cursor, fields)

Search NASA CMR tools for a specific parent collection and return all associated normalized UMM-T records. Key fields in each returned item: - concept_id: CMR tool concept ID - native_id: native ID of the tool record - revision_id: revision ID of the tool metadata - provider_id: provider ID of the tool - name: tool name - type: tool type (e.g., Downloadable Tool, Web User Interface, Web Portal, Model) - version: tool version string - description: human-readable tool description - url: Primary URL for directly accessing the tool - supported_input_formats: file formats the tool can read (e.g., HDF5, NETCDF-4, GeoTIFF) - supported_output_formats: file formats the tool can produce - supported_operating_systems: OS compatibility (name and version) - supported_browsers: browser compatibility (name and version) - supported_software_languages: programming language compatibility - tool_keywords: Earth science keyword taxonomy for the tool - organizations: providers, developers, or publishers of the tool - potential_action: smart handoff definition for parameterized deep links (e.g., 'Open in Giovanni') Key parameters: - collection_concept_id: required parent collection concept ID Iteration & Refinement: - All tools associated with the collection are fetched in a single request. Paging is not supported. Note: A collection may be associated with multiple tools of different types. Check type to distinguish between downloadable tools, web user interfaces, and web portals.

輸入結構描述

{
  "type": "object",
  "properties": {
    "collection_concept_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50). Keep this small to avoid context window bloat. When using limit > 10, always specify the fields parameter.",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results. Pass the exact next_cursor string returned by the previous tool call. Cursors are query-scoped: they lock in the original search parameters and cannot be reused across different tools or different queries. If you need to change any search parameter, start a new search without a cursor."
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Status of the tool execution",
      "enum": [
        "success",
        "no_results",
        "error"
      ],
      "title": "SearchStatus",
      "type": "string"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Error details when status is error",
      "title": "Error Message"
    },
    "total_hits": {
      "default": 0,
      "description": "Total number of matching items",
      "title": "Total Hits",
      "type": "integer"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page; None when no more results",
      "title": "Next Cursor"
    },
    "tools": {
      "description": "Normalized tool results mapped from UMM-T",
      "items": {
        "description": "Normalized tool result for direct CMR-backed retrieval.",
        "properties": {
          "access_constraints": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Constraints for accessing the tool",
            "title": "Access Constraints"
          },
          "concept_id": {
            "description": "CMR tool concept ID",
            "title": "Concept Id",
            "type": "string"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "A brief description of the tool",
            "title": "Description"
          },
          "doi": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Digital Object Identifier of the tool",
            "title": "Doi"
          },
          "long_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The long name of the tool",
            "title": "Long Name"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The name of the tool",
            "title": "Name"
          },
          "native_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The native ID of the tool record",
            "title": "Native Id"
          },
          "organizations": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Organizations responsible for the tool",
            "title": "Organizations"
          },
          "potential_action": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Smart handoff definition for parameterized deep links",
            "title": "Potential Action"
          },
          "provider_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The provider ID of the tool",
            "title": "Provider Id"
          },
          "quality": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Quality information about the tool",
            "title": "Quality"
          },
          "related_urls": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Documentation, guides, or other related links",
            "title": "Related Urls"
          },
          "revision_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The revision ID of the tool metadata",
            "title": "Revision Id"
          },
          "supported_browsers": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Browsers and versions supported by the tool",
            "title": "Supported Browsers"
          },
          "supported_input_formats": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "List of input format names supported by the tool",
            "title": "Supported Input Formats"
          },
          "supported_operating_systems": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Operating systems and versions supported by the tool",
            "title": "Supported Operating Systems"
          },
          "supported_output_formats": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "List of output format names supported by the tool",
            "title": "Supported Output Formats"
          },
          "supported_software_languages": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Programming languages and versions supported by the tool",
            "title": "Supported Software Languages"
          },
          "tool_keywords": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Earth science keywords representative of the tool",
            "title": "Tool Keywords"
          },
          "type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The type of the tool (e.g., Downloadable Tool, Web User Interface, Web Portal, Model)",
            "title": "Type"
          },
          "url": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Primary URL for accessing the tool",
            "title": "Url"
          },
          "use_constraints": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Restrictions or limitations on using the tool",
            "title": "Use Constraints"
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The edition or version of the tool",
            "title": "Version"
          }
        },
        "required": [
          "concept_id"
        ],
        "title": "ToolResult",
        "type": "object"
      },
      "title": "Tools",
      "type": "array"
    }
  },
  "required": [
    "status"
  ],
  "description": "Output model for get_tools.",
  "title": "GetToolsOutput"
}
🟢get_variables(collection_concept_id, keyword, limit, cursor, fields)

Discover scientific variables and measurements associated with a collection, or look up variables by keyword. Use this tool to understand dataset variables, dimensions, and data processing parameters (such as scale, offset, and fill values) before downloading or analyzing data. Key fields in each returned item: - concept_id: CMR variable concept ID - name: Variable short name - long_name: Variable long name - definition: Variable definition - data_type: Data type of the variable - units: Units of measurement - scale: Scale factor - offset: Offset value - fill_values: Values indicating missing or invalid data - valid_ranges: Valid data ranges - dimensions: Variable dimensions

輸入結構描述

{
  "type": "object",
  "properties": {
    "collection_concept_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50). Keep this small to avoid context window bloat. When using limit > 10, always specify the fields parameter.",
      "type": "integer"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page of results. Pass the exact next_cursor string returned by the previous tool call. Cursors are query-scoped: they lock in the original search parameters and cannot be reused across different tools or different queries. If you need to change any search parameter, start a new search without a cursor."
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

輸出結構描述

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Status of the tool execution",
      "enum": [
        "success",
        "no_results",
        "error"
      ],
      "title": "SearchStatus",
      "type": "string"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Error details when status is error",
      "title": "Error Message"
    },
    "total_hits": {
      "default": 0,
      "description": "Total number of matching items",
      "title": "Total Hits",
      "type": "integer"
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination token for the next page; None when no more results",
      "title": "Next Cursor"
    },
    "variables": {
      "description": "Normalized variable results mapped from UMM-V",
      "items": {
        "description": "Normalized variable result for direct CMR-backed retrieval.",
        "properties": {
          "concept_id": {
            "description": "CMR variable concept ID",
            "title": "Concept Id",
            "type": "string"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The short name of the variable",
            "title": "Name"
          },
          "long_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The long name of the variable",
            "title": "Long Name"
          },
          "definition": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The definition of the variable",
            "title": "Definition"
          },
          "data_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The data type of the variable",
            "title": "Data Type"
          },
          "units": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The units of the variable",
            "title": "Units"
          },
          "scale": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The scale factor for the variable data",
            "title": "Scale"
          },
          "offset": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The offset for the variable data",
            "title": "Offset"
          },
          "fill_values": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Fill values used for missing or invalid data",
            "title": "Fill Values"
          },
          "valid_ranges": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Valid data ranges for the variable",
            "title": "Valid Ranges"
          },
          "dimensions": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Dimensions associated with the variable",
            "title": "Dimensions"
          },
          "standard_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "The CF Standard Name of the variable",
            "title": "Standard Name"
          },
          "science_keywords": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "GCMD Science Keywords hierarchy",
            "title": "Science Keywords"
          },
          "variable_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Type of variable (e.g., SCIENCE_VARIABLE, COORDINATE)",
            "title": "Variable Type"
          },
          "variable_sub_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Sub-type of variable",
            "title": "Variable Sub Type"
          },
          "sets": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Logical groupings for the variable",
            "title": "Sets"
          },
          "measurement_identifiers": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Measurement context and provenance",
            "title": "Measurement Identifiers"
          },
          "sampling_identifiers": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Sampling method context",
            "title": "Sampling Identifiers"
          },
          "related_urls": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "URLs specific to the variable",
            "title": "Related Urls"
          }
        },
        "required": [
          "concept_id"
        ],
        "title": "VariableResult",
        "type": "object"
      },
      "title": "Variables",
      "type": "array"
    }
  },
  "required": [
    "status"
  ],
  "description": "Output model for get_variables.",
  "title": "GetVariablesOutput"
}

社群

為此伺服器評分

證據

近期觀測

已驗證未記錄版本7 個工具
已驗證未記錄版本7 個工具