Skip to main content
Glama

DaedalMap Wildfire Events

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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "pack_id": "<pack_id>",
      "metrics": "<metrics>",
      "filters": "<filters>"
    },
    "name": "get_data"
  }
}

Input 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

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. Changed1 schema field changed
    • changedInput schema / properties / filters / additionalProperties
      Previous value: -{
      -  "anyOf": [
      -    {
      -      "type": [
      -        "string",
      -        "number",
      -        "integer",
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    {
      -      "items": {
      -        "type": [
      -          "string",
      -          "number",
      -          "integer",
      -          "boolean"
      -        ]
      -      },
      -      "type": "array"
      -    }
      -  ]
      -}New value: +false
  2. 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."
  3. Added

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive, closed-world, so the safety profile is covered. The description adds genuinely non-obvious behavior beyond that: a parent administrative loc_id expands to descendant rows at the pack's published grain, and disaster rows carry stable event_id values. It does not discuss the 500-row cap implications, pagination, or truncation behavior.

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

Conciseness4/5

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

Four sentences, front-loaded with the core action before prerequisites and edge-case semantics. The opening enumeration of metrics/filters/sorting/limit slightly duplicates schema content, but the remainder (descendant expansion, event_id stability, prerequisite call) is all load-bearing.

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

Completeness4/5

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

For a seven-parameter, deeply nested query tool with an output schema, this covers the pieces an agent cannot infer: the prerequisite chain via get_pack, hierarchical loc_id behavior, and where to go next for events. Return shape is handled by the output schema, so the remaining gap is minor — mainly what happens near the row limit.

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

Parameters4/5

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

Schema coverage is high (86%), so the baseline is 3, but the description earns more: it clarifies that metric ids must be exact and published by get_pack, that region filters are loc_id-based with hierarchical expansion semantics, and that event_count is a conditional aggregate metric. Sorting and limit are named but not elaborated beyond the schema.

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?

States a specific verb and resource ("Retrieve rows from one selected published data pack") and immediately scopes it: exact metrics, loc_id region filters, time/metric filters, sorting, row limit. It distinguishes itself from siblings by naming get_pack as the prerequisite and get_event as the drill-down follow-up, so an agent can place it in the workflow without opening a 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?

Gives an explicit prerequisite ("Call get_pack first") and a partial exclusion ("geometry families use their focused next-step tools"), which is exactly the routing information needed. It stops short of naming those geometry tools or defining when to prefer a different row source, so it is strong but not exhaustive.

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.