Skip to main content
Glama

groundhog.markets

Find a place

places
Read-onlyIdempotent

Find a place slug by name, City, ST, airport code or lat,lon; says full blend or grid only. format=json also returns structuredContent; the JSON Schema is at https://groundhog.markets/api/v1/schema.json

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": {
      "q": "<q>"
    },
    "name": "places"
  }
}

Input Schema

NameRequiredDescriptionDefault
qYes
limitNo
fieldsNofull (default) | compact: leave out null JSON keys (format=json)
formatNodefault tsv
compactNotrue = fields=compact

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / properties / compact
      Added value: +{
      +  "description": "true = fields=compact",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / fields / description
      Previous value: -"full (default) | compact: leave out null members of the JSON (structuredContent and format=json)"New value: +"full (default) | compact: leave out null JSON keys (format=json)"
    • addedInput schema / properties / format
      Added value: +{
      +  "description": "default tsv",
      +  "enum": [
      +    "tsv",
      +    "json"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "credit_keys": {
      -      "description": "Their keys (/credits lists every line).",
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "credits": {
      -      "description": "Credit strings to keep when you repeat numbers.",
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "credits_url": {
      -      "description": "The full credits page.",
      -      "type": "string"
      -    },
      -    "q": {
      -      "description": "The search.",
      -      "type": "string"
      -    },
      -    "results": {
      -      "description": "Best matches first.",
      -      "items": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "admin1": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "cc": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "coverage": {
      -            "description": "full = every source; grid = global models only for now.",
      -            "enum": [
      -              "full",
      -              "grid"
      -            ]
      -          },
      -          "display": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "lat": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "lon": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "slug": {
      -            "type": "string"
      -          },
      -          "stations": {
      -            "description": "Station ICAOs, primary first.",
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "tier": {
      -            "description": "core | demand | search (settle points are never listed).",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "tz": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "slug",
      -          "coverage",
      -          "stations"
      -        ],
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "v": {
      -      "const": 1,
      -      "description": "Body version."
      -    }
      -  },
      -  "required": [
      -    "v",
      -    "q",
      -    "results",
      -    "credits",
      -    "credit_keys",
      -    "credits_url"
      -  ],
      -  "type": "object"
      -}New value: +null
  2. Changed2 schema fields changed
    • addedInput schema / properties / fields
      Added value: +{
      +  "description": "full (default) | compact: leave out null members of the JSON (structuredContent and format=json)",
      +  "enum": [
      +    "full",
      +    "compact"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "credit_keys": {
      +      "description": "Their keys (/credits lists every line).",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "credits": {
      +      "description": "Credit strings to keep when you repeat numbers.",
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "credits_url": {
      +      "description": "The full credits page.",
      +      "type": "string"
      +    },
      +    "q": {
      +      "description": "The search.",
      +      "type": "string"
      +    },
      +    "results": {
      +      "description": "Best matches first.",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "admin1": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "cc": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "coverage": {
      +            "description": "full = every source; grid = global models only for now.",
      +            "enum": [
      +              "full",
      +              "grid"
      +            ]
      +          },
      +          "display": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "lat": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "lon": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "slug": {
      +            "type": "string"
      +          },
      +          "stations": {
      +            "description": "Station ICAOs, primary first.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "tier": {
      +            "description": "core | demand | search (settle points are never listed).",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "tz": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "slug",
      +          "coverage",
      +          "stations"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "v": {
      +      "const": 1,
      +      "description": "Body version."
      +    }
      +  },
      +  "required": [
      +    "v",
      +    "q",
      +    "results",
      +    "credits",
      +    "credit_keys",
      +    "credits_url"
      +  ],
      +  "type": "object"
      +}
  3. First observed

TDQS

B3.1/5.0
Behavior3/5

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

Annotations already establish readOnlyHint, idempotentHint, destructiveHint=false, and openWorldHint=false, so safety is covered. The description adds real value by noting that format=json returns structuredContent and by linking the JSON Schema, but says nothing about limit defaults, result ordering, or what happens when no match is found.

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

Conciseness3/5

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

Two sentences, front-loaded with the core capability, which is good. However, "says full blend or grid only" is cryptic filler that reads like internal shorthand, and the schema URL consumes space that could have described return behavior instead.

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

Completeness3/5

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

There is no output schema, so the description carries the burden of explaining returns; it partially does so by mentioning the slug, the blend/grid indicator, and structuredContent under format=json. For a 5-parameter tool it still leaves the limit semantics and empty-result behavior unexplained.

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?

With 60% schema coverage, the schema already documents fields and format enums. The description usefully expands q to the four accepted query shapes, which the bare string type does not convey, and links format=json to structuredContent; it adds nothing about limit, compact, or the relationship between compact and fields=compact.

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

Purpose4/5

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

The description uses a concrete verb and resource ("Find a place slug") and enumerates the accepted query forms: name, City/ST, airport code, or lat,lon. The trailing clause "says full blend or grid only" is opaque jargon that muddies rather than sharpens the purpose, and there is no explicit differentiation from siblings like search or coverage.

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

Usage Guidelines2/5

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

No when-to-use or when-not-to-use guidance is given, and no alternative tool is named for the case where the agent already has a slug or wants a fuzzy match. The accepted input formats imply a geocoding/lookup role, but the agent must infer that this is a prerequisite step for other tools.

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.

Resources