Skip to main content
Glama

Aviation & Space Weather Data (Tanod)

get_weather

Read-onlyIdempotent

weatherpeek: hourly weather forecast for a point or a city. For airport observations use get_metar. Input: either lat and lon together, or place alone, plus optional hours. place matches cities of 15,000+ people offline ("City" or "City, CC" with an ISO country code); no match is a 404 place_not_found (not charged). Upstream errors are a 5xx and are not charged. Typically 0.1-2 s. Price: USD 0.002. Free: 5 weather forecasts per IP per UTC day. Data: MET Norway and GeoNames, both CC BY 4.0; credit them when you show or republish it (see attribution). Forecasts are numerical weather model output and can be wrong: not for safety-critical decisions (aviation, marine, severe-weather warnings); use official services for those. Docs: https://tanod.dev/learn/weather-api-no-key.html

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_weather"
  }
}

Input Schema

NameRequiredDescriptionDefault
latNoLatitude (-90..90); give lat and lon together, or place.
lonNoLongitude (-180..180); give lat and lon together, or place.
hoursNoHourly rows to return.
placeNoCity name, optionally "City, CC" with an ISO country code (cities with 15,000+ people); give place alone, or lat and lon.

Output Schema

NameRequiredDescriptionDefault
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
hoursNo
unitsNo
cachedNo
hourlyNo
locationNo
updated_atNo
attributionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • changedInput schema / properties / hours / description
      Previous value: -"Hourly rows to return (1-48, default 24)."New value: +"Hourly rows to return."
    • removedInput schema / properties / hours / title
      Removed value: -"Hours"
    • removedInput schema / properties / lat / default
      Removed value: -null
    • removedInput schema / properties / lat / title
      Removed value: -"Lat"
    • removedInput schema / properties / lon / default
      Removed value: -null
    • removedInput schema / properties / lon / title
      Removed value: -"Lon"
    • removedInput schema / properties / place / default
      Removed value: -null
    • removedInput schema / properties / place / title
      Removed value: -"Place"
    • removedInput schema / title
      Removed value: -"get_weatherArguments"
    • removedOutput schema / properties / attribution / properties
      Removed value: -{
      -  "license": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "places": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "weather": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / hourly / items
      Removed value: -{
      -  "properties": {
      -    "air_temperature": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "cloud_area_fraction": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "precipitation_amount": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "relative_humidity": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "symbol_code": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "time": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "wind_from_direction": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "wind_speed": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / location / properties
      Removed value: -{
      -  "lat": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "lon": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "place": {
      -    "type": [
      -      "object",
      -      "null"
      -    ]
      -  }
      -}
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "attribution": {
      +      "properties": {
      +        "license": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "places": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "weather": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "cached": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "error": {
      +      "description": "Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object."
      +    },
      +    "hourly": {
      +      "items": {
      +        "properties": {
      +          "air_temperature": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "cloud_area_fraction": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "precipitation_amount": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "relative_humidity": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "symbol_code": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "time": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "wind_from_direction": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "wind_speed": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "hours": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "location": {
      +      "properties": {
      +        "lat": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "lon": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "place": {
      +          "type": [
      +            "object",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "units": {
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "updated_at": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  3. First observed

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, openWorld, non-destructive), yet the description still adds substantive behavior: price (USD 0.002), a 5/IP/UTC-day free cap, 0.1-2 s latency, and error semantics (404 place_not_found and 5xx are not charged). It also discloses data provenance and a required CC BY 4.0 attribution. It stops short of describing pagination or result-set shape, but the output schema covers returns.

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?

Front-loaded with what the tool returns and the sibling it is not, and every clause carries operational facts. The back half is semicolon-dense (pricing, quota, licensing, caveats strung together), which is efficient but cramped rather than cleanly structured.

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 4-param read tool with annotations and an output schema, the description covers the remaining unknowns an agent needs: cost, free quota, latency, failure modes and their billing impact, licensing obligations, and an accuracy disclaimer. Nothing material is left to inference.

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 100%, so the baseline is 3, but the description adds the consequence of an unmatched `place` (404 place_not_found, not charged) and reinforces the lat/lon-versus-place exclusivity, which is behavioral meaning not present in the schema. The 15,000+ city and ISO country-code details largely duplicate the schema wording.

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 ('hourly weather forecast for a point or a city') and immediately distinguishes itself from the nearest sibling by routing airport observations to get_metar. The scope is unambiguous without opening either schema.

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

Usage Guidelines5/5

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

Gives explicit inclusion criteria, an explicit alternative ('For airport observations use get_metar'), and explicit exclusions ('not for safety-critical decisions ... use official services'). The input shapes are also spelled out as mutually exclusive options.

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.