Skip to main content
Glama

DaedalMap Hurricane and Tropical Cyclone Data

Get Data

get_data
Read-onlyIdempotent

Retrieve rows from one selected published data pack using exact metrics, loc_id-based region filters, time/metric filters, sorting, and a row limit. Disaster event rows include stable event_id values for get_event drill-down. A parent administrative loc_id selects matching descendant rows at the pack's published grain. Call get_pack first; geometry families use their focused next-step tools.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sortNoSort by a sortable field from get_pack; direction defaults to asc.
limitNoMaximum number of rows to return for the requested source or pack.
outputNoOptional response controls. v1 supports rows only.
filtersYes
metricsYesExact metric ids from get_pack. Use event_count for aggregate counts only when get_pack publishes it.
pack_idYesPack identifier from get_catalog. Newly catalog-admitted packs require no MCP schema change.
request_idNoOptional caller-supplied request id for tracing and idempotency.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
rowsNo
sortNo
errorNo
limitNo
reasonNo
pack_idNo
guidanceNo
warningsNo
next_stepNo
row_countNo
source_idNo
truncatedNo
provenanceNo
query_modeNo
request_idNo
capability_idNo
clarificationNo
filters_appliedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed13 schema fields changed
    • addedInput schema / properties / filters / additionalProperties
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": [
      +        "string",
      +        "number",
      +        "integer",
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    {
      +      "items": {
      +        "type": [
      +          "string",
      +          "number",
      +          "integer",
      +          "boolean"
      +        ]
      +      },
      +      "type": "array"
      +    }
      +  ]
      +}
    • removedInput schema / properties / filters / description
      Removed value: -"Structured filters including time, region_ids, and compare clauses."
    • addedInput schema / properties / filters / properties
      Added value: +{
      +  "compare": {
      +    "description": "Threshold filters using filterable fields or selected metric ids published by get_pack.",
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "field": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "op": {
      +          "enum": [
      +            "=",
      +            "!=",
      +            ">",
      +            ">=",
      +            "<",
      +            "<="
      +          ],
      +          "type": "string"
      +        },
      +        "value": {}
      +      },
      +      "required": [
      +        "field",
      +        "op",
      +        "value"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  "equals": {
      +    "additionalProperties": {
      +      "anyOf": [
      +        {
      +          "type": [
      +            "string",
      +            "number",
      +            "integer",
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        {
      +          "items": {
      +            "type": [
      +              "string",
      +              "number",
      +              "integer",
      +              "boolean"
      +            ]
      +          },
      +          "type": "array"
      +        }
      +      ]
      +    },
      +    "description": "Exact field/value filters using filterable fields published by get_pack.",
      +    "type": "object"
      +  },
      +  "region_ids": {
      +    "description": "Canonical country or hierarchical loc_ids from get_pack, such as JPN or USA-TX.",
      +    "items": {
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "minItems": 1,
      +    "type": "array",
      +    "uniqueItems": true
      +  },
      +  "time": {
      +    "additionalProperties": false,
      +    "anyOf": [
      +      {
      +        "required": [
      +          "value"
      +        ]
      +      },
      +      {
      +        "required": [
      +          "start"
      +        ]
      +      },
      +      {
      +        "required": [
      +          "end"
      +        ]
      +      }
      +    ],
      +    "description": "Inclusive ISO-8601 date/datetime or integer-year selection. Use YYYY-MM-DD, not partial YYYY-MM strings.",
      +    "properties": {
      +      "end": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "format": "date",
      +            "type": "string"
      +          },
      +          {
      +            "type": "integer"
      +          }
      +        ]
      +      },
      +      "granularity": {
      +        "enum": [
      +          "daily",
      +          "weekly",
      +          "monthly",
      +          "yearly",
      +          "timestamp"
      +        ],
      +        "type": "string"
      +      },
      +      "start": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "format": "date",
      +            "type": "string"
      +          },
      +          {
      +            "type": "integer"
      +          }
      +        ]
      +      },
      +      "value": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "format": "date",
      +            "type": "string"
      +          },
      +          {
      +            "type": "integer"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  }
      +}
    • changedInput schema / properties / metrics / description
      Previous value: -"Metric ids to return. Use event_count for aggregate counts when supported."New value: +"Exact metric ids from get_pack. Use event_count for aggregate counts only when get_pack publishes it."
    • addedInput schema / properties / metrics / items / minLength
      Added value: +1
    • addedInput schema / properties / metrics / minItems
      Added value: +1
    • addedInput schema / properties / metrics / uniqueItems
      Added value: +true
    • addedInput schema / properties / output / additionalProperties
      Added value: +false
    • changedInput schema / properties / output / description
      Previous value: -"Optional output controls such as response format hints."New value: +"Optional response controls. v1 supports rows only."
    • addedInput schema / properties / output / properties
      Added value: +{
      +  "format": {
      +    "default": "rows",
      +    "enum": [
      +      "rows"
      +    ],
      +    "type": "string"
      +  },
      +  "include_provenance": {
      +    "default": false,
      +    "type": "boolean"
      +  }
      +}
    • addedInput schema / properties / pack_id / minLength
      Added value: +1
    • changedInput schema / properties / sort / anyOf
      Previous value: -[
      -  {
      -    "type": "array"
      -  },
      -  {
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "direction": {
      +        "enum": [
      +          "asc",
      +          "desc"
      +        ],
      +        "type": "string"
      +      },
      +      "field": {
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "field"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "direction": {
      +          "enum": [
      +            "asc",
      +            "desc"
      +          ],
      +          "type": "string"
      +        },
      +        "field": {
      +          "minLength": 1,
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "field"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  }
      +]
    • changedInput schema / properties / sort / description
      Previous value: -"Optional sort instructions for row-returning queries."New value: +"Sort by a sortable field from get_pack; direction defaults to asc."
  2. Added

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already signal read-only, idempotent, non-destructive behavior. The description adds value by disclosing stable event_id values for get_event drill-down and that a parent administrative loc_id selects descendant rows at the pack's published grain. These behavioral details go beyond the annotation flags and do not contradict them.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is four sentences, front-loaded with the core purpose and followed by behavioral routing details. Every sentence contributes information; there is no filler or restatement of the tool name.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with seven parameters and nested objects, the description plus rich schema and annotations cover prerequisites, sibling routing, regional hierarchy behavior, and the event drill-down path. The output schema exists, so the description does not need to document return values.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 86%, so parameter semantics are mostly carried by the input schema. The description's phrases such as 'exact metrics' and 'loc_id-based region filters' reinforce, but do not materially extend, the schema descriptions for metrics, filters, and region_ids.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific action and resource: 'Retrieve rows from one selected published data pack' and enumerates the filtering, sorting, and limiting semantics. It also distances itself from siblings by saying 'Call get_pack first' and pointing geometry families to focused tools, so an agent can tell get_data apart from get_catalog, get_pack, and get_event without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives a clear prerequisite ('Call get_pack first') and an explicit exclusion ('geometry families use their focused next-step tools'). It also describes the get_event drill-down path. It does not enumerate every sibling-selection condition, such as when to use get_catalog versus get_pack, so it stops short of full coverage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.