Skip to main content
Glama
DogPolicies MCP Server

DogPolicies MCP Server

by xultrax-web

What is near a town

dogpolicies_near
Read-onlyIdempotent

Find dog-friendly beaches, parks, trails, lodgings, campgrounds and patios near a California or Nevada place or coordinates, grouped by kind and nearest first, with verified rules and sources.

Instructions

What can my dog do in or around this town, neighborhood or region: beaches, parks, trails, hotels, campgrounds, cabins, patios and rest areas, nearest first? Answers "dog-friendly things in X" questions, grouped by kind. It does not check hotels against a dog's weight or a fee budget. Input: place as people say it: a city, county, neighborhood or alias ("Van Nuys", "Koreatown", "Venice Beach", "the Mission", "DTLA"), an area or region ("Lake Tahoe", "East Bay", "Central Valley"), or near={lat, lon}. Small spelling slips ("Montery") are corrected and labeled. If nothing is inside the radius it widens to 30, 60, then 100 miles and says so. Each result carries the dog rule, verified date and source URL. An unknown name comes back as an answer with did_you_mean, the nearest towns and next (a larger town or county that is covered).

Examples:

  • "What can my dog do in Carmel?" -> place="Carmel"

  • "Dog beaches and parks around South Lake Tahoe" -> place="South Lake Tahoe", types=["beach","park"]

  • "Anything dog-friendly in Van Nuys?" -> place="Van Nuys"

  • "Anything dog-friendly within 5 miles of here" -> near={lat:36.6, lon:-121.9}, radius_miles=5

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": "dogpolicies_near"
  }
}

Input Schema

NameRequiredDescriptionDefault
nearNoA point as an alternative to a town: one of place or near
placeNoA city, county, area, region, neighborhood or airport in California or Nevada, e.g. "Monterey", "South Lake Tahoe", "Washoe County, NV", "Las Vegas", "East Bay", "Lake Tahoe", "Central Valley", "Van Nuys", "Koreatown", "Venice Beach", "the Mission", "DTLA", "SFO" or "LAX airport" (an airport searches 5 miles unless radius_miles is given). Accepts the place as people say it; small spelling slips ("Montery") are corrected and the answer says so.
typesNoKinds to include; all by default
per_typeNoNearest results to show per kind
radius_milesNoSearch radius in miles around the town or point (an area is its own boundary; the radius is ignored)
response_formatNo'markdown' for readable text, 'json' for structured datamarkdown
dogs_allowed_onlyNoLeave out places where dogs are not allowed

Output Schema

NameRequiredDescriptionDefault
codeNoWith an outcome other than ok: not_found, invalid, unavailable
nextNoCalls that would answer the question, in words
as_ofYesDate the data was built (YYYY-MM-DD)
labelYes
totalYes
centerYesThe point searched around; null when the place was not found
groupsYes
licenseYes
messageNoWhat happened, in a sentence
nearestNo
outcomeNoAbsent or ok: a normal answer. no_match: nothing in the data matches, see did_you_mean, nearest and next. bad_input: the arguments cannot be used as given, see next. partial: some of the ids were found, see missing. unavailable: a live source could not be read. None of these is an error.
acceptedNoWith bad_input: each argument that could not be read, with the values it accepts
did_you_meanNoClose matches to what was asked for: towns, places, slugs or brands, best first
radius_milesYes
resolved_fromNoSet when a word was read as the value the tool uses: hotel as lodging, NB as north. Each key is the argument; asked is what was sent, used what it was read as
attribution_urlYes
attribution_textYes
radius_widened_fromNoSet when the radius asked for held nothing and the search widened

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changedv0.5.0
    • changedInput schema / properties / near / description
      Previous value: -"A point instead of a town; give one of place or near"New value: +"A point as an alternative to a town: one of place or near"
    • changedInput schema / properties / place / description
      Previous value: -"A city, county, area, region or neighborhood in California or Nevada, e.g. \"Monterey\", \"South Lake Tahoe\", \"Washoe County, NV\", \"Las Vegas\", \"East Bay\", \"Lake Tahoe\", \"Central Valley\" or \"Van Nuys\". Small spelling slips are corrected and the answer says so."New value: +"A city, county, area, region, neighborhood or airport in California or Nevada, e.g. \"Monterey\", \"South Lake Tahoe\", \"Washoe County, NV\", \"Las Vegas\", \"East Bay\", \"Lake Tahoe\", \"Central Valley\", \"Van Nuys\", \"Koreatown\", \"Venice Beach\", \"the Mission\", \"DTLA\", \"SFO\" or \"LAX airport\" (an airport searches 5 miles unless radius_miles is given). Accepts the place as people say it; small spelling slips (\"Montery\") are corrected and the answer says so."
    • addedOutput schema / properties / accepted
      Added value: +{
      +  "additionalProperties": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "description": "With bad_input: each argument that could not be read, with the values it accepts",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / groups / items / properties / places / items / properties / answer / description
      Added value: +"The one-line answer; while a seasonal rule applies today it leads with it (see today)"
    • addedOutput schema / properties / groups / items / properties / places / items / properties / closed_now
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Present only when Caltrans reports this rest area fully closed now. Live feed data, not a verified rule: check quickmap.dot.ca.gov",
      +  "properties": {
      +    "fetched_at": {
      +      "description": "When the conditions loop read the feed",
      +      "type": "string"
      +    },
      +    "reason": {
      +      "description": "Caltrans' own reason, as published",
      +      "type": "string"
      +    },
      +    "source": {
      +      "const": "Caltrans",
      +      "type": "string"
      +    },
      +    "until": {
      +      "description": "Caltrans' end time (ISO); null when no end is set",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "reason",
      +    "until",
      +    "source",
      +    "fetched_at"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / groups / items / properties / places / items / properties / today
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Only for a place with seasonal dog rules (plover nesting season, summer beach hours): which applies on the server's date, until when, and which starts next, with the source. Repeat sentence with the answer.",
      +  "properties": {
      +    "date": {
      +      "description": "The date this was computed for: the server's date",
      +      "type": "string"
      +    },
      +    "in_effect": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "access": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "yes",
      +                  "yes_restricted",
      +                  "no"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "area": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "days_left": {
      +            "type": "number"
      +          },
      +          "ends": {
      +            "description": "Last day of this run (YYYY-MM-DD)",
      +            "type": "string"
      +          },
      +          "leash": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "rule": {
      +            "description": "The seasonal rule in plain words",
      +            "type": "string"
      +          },
      +          "season": {
      +            "description": "When it runs, in the source's dates: \"July 1 to May 15\"",
      +            "type": "string"
      +          },
      +          "starts": {
      +            "description": "First day of this run (YYYY-MM-DD)",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "rule",
      +          "season",
      +          "area",
      +          "access",
      +          "leash",
      +          "starts",
      +          "ends",
      +          "days_left"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "in_season": {
      +      "description": "true: a seasonal rule is in effect on that date; null: the source gives a season without dates",
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "next": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {},
      +          "properties": {
      +            "access": {
      +              "anyOf": [
      +                {
      +                  "enum": [
      +                    "yes",
      +                    "yes_restricted",
      +                    "no"
      +                  ],
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "area": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "ends": {
      +              "description": "Last day of this run (YYYY-MM-DD)",
      +              "type": "string"
      +            },
      +            "in_days": {
      +              "type": "number"
      +            },
      +            "leash": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "rule": {
      +              "description": "The seasonal rule in plain words",
      +              "type": "string"
      +            },
      +            "season": {
      +              "description": "When it runs, in the source's dates: \"July 1 to May 15\"",
      +              "type": "string"
      +            },
      +            "starts": {
      +              "description": "First day of this run (YYYY-MM-DD)",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "rule",
      +            "season",
      +            "area",
      +            "access",
      +            "leash",
      +            "starts",
      +            "ends",
      +            "in_days"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "publisher": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "quote": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "sentence": {
      +      "description": "Leads answer and citation while a seasonal rule applies or starts within 14 days; null otherwise",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "source_url": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "starts_soon": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "access": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "yes",
      +                  "yes_restricted",
      +                  "no"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "area": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "ends": {
      +            "description": "Last day of this run (YYYY-MM-DD)",
      +            "type": "string"
      +          },
      +          "in_days": {
      +            "type": "number"
      +          },
      +          "leash": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "rule": {
      +            "description": "The seasonal rule in plain words",
      +            "type": "string"
      +          },
      +          "season": {
      +            "description": "When it runs, in the source's dates: \"July 1 to May 15\"",
      +            "type": "string"
      +          },
      +          "starts": {
      +            "description": "First day of this run (YYYY-MM-DD)",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "rule",
      +          "season",
      +          "area",
      +          "access",
      +          "leash",
      +          "starts",
      +          "ends",
      +          "in_days"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "undated": {
      +      "description": "Seasons the source states without dates: not known to apply",
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "access": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "yes",
      +                  "yes_restricted",
      +                  "no"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "area": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "leash": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "rule": {
      +            "description": "The seasonal rule in plain words",
      +            "type": "string"
      +          },
      +          "season": {
      +            "description": "When it runs, in the source's dates: \"July 1 to May 15\"",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "rule",
      +          "season",
      +          "area",
      +          "access",
      +          "leash"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "verified_at": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "date",
      +    "in_season",
      +    "sentence",
      +    "in_effect",
      +    "starts_soon",
      +    "next",
      +    "undated",
      +    "source_url",
      +    "publisher",
      +    "quote",
      +    "verified_at"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / nearest / items / properties / answer / description
      Added value: +"The one-line answer; while a seasonal rule applies today it leads with it (see today)"
    • addedOutput schema / properties / nearest / items / properties / closed_now
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Present only when Caltrans reports this rest area fully closed now. Live feed data, not a verified rule: check quickmap.dot.ca.gov",
      +  "properties": {
      +    "fetched_at": {
      +      "description": "When the conditions loop read the feed",
      +      "type": "string"
      +    },
      +    "reason": {
      +      "description": "Caltrans' own reason, as published",
      +      "type": "string"
      +    },
      +    "source": {
      +      "const": "Caltrans",
      +      "type": "string"
      +    },
      +    "until": {
      +      "description": "Caltrans' end time (ISO); null when no end is set",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "reason",
      +    "until",
      +    "source",
      +    "fetched_at"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / nearest / items / properties / today
      Added value: +{
      +  "additionalProperties": {},
      +  "description": "Only for a place with seasonal dog rules (plover nesting season, summer beach hours): which applies on the server's date, until when, and which starts next, with the source. Repeat sentence with the answer.",
      +  "properties": {
      +    "date": {
      +      "description": "The date this was computed for: the server's date",
      +      "type": "string"
      +    },
      +    "in_effect": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "access": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "yes",
      +                  "yes_restricted",
      +                  "no"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "area": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "days_left": {
      +            "type": "number"
      +          },
      +          "ends": {
      +            "description": "Last day of this run (YYYY-MM-DD)",
      +            "type": "string"
      +          },
      +          "leash": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "rule": {
      +            "description": "The seasonal rule in plain words",
      +            "type": "string"
      +          },
      +          "season": {
      +            "description": "When it runs, in the source's dates: \"July 1 to May 15\"",
      +            "type": "string"
      +          },
      +          "starts": {
      +            "description": "First day of this run (YYYY-MM-DD)",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "rule",
      +          "season",
      +          "area",
      +          "access",
      +          "leash",
      +          "starts",
      +          "ends",
      +          "days_left"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "in_season": {
      +      "description": "true: a seasonal rule is in effect on that date; null: the source gives a season without dates",
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "next": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {},
      +          "properties": {
      +            "access": {
      +              "anyOf": [
      +                {
      +                  "enum": [
      +                    "yes",
      +                    "yes_restricted",
      +                    "no"
      +                  ],
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "area": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "ends": {
      +              "description": "Last day of this run (YYYY-MM-DD)",
      +              "type": "string"
      +            },
      +            "in_days": {
      +              "type": "number"
      +            },
      +            "leash": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "rule": {
      +              "description": "The seasonal rule in plain words",
      +              "type": "string"
      +            },
      +            "season": {
      +              "description": "When it runs, in the source's dates: \"July 1 to May 15\"",
      +              "type": "string"
      +            },
      +            "starts": {
      +              "description": "First day of this run (YYYY-MM-DD)",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "rule",
      +            "season",
      +            "area",
      +            "access",
      +            "leash",
      +            "starts",
      +            "ends",
      +            "in_days"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "publisher": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "quote": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "sentence": {
      +      "description": "Leads answer and citation while a seasonal rule applies or starts within 14 days; null otherwise",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "source_url": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "starts_soon": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "access": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "yes",
      +                  "yes_restricted",
      +                  "no"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "area": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "ends": {
      +            "description": "Last day of this run (YYYY-MM-DD)",
      +            "type": "string"
      +          },
      +          "in_days": {
      +            "type": "number"
      +          },
      +          "leash": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "rule": {
      +            "description": "The seasonal rule in plain words",
      +            "type": "string"
      +          },
      +          "season": {
      +            "description": "When it runs, in the source's dates: \"July 1 to May 15\"",
      +            "type": "string"
      +          },
      +          "starts": {
      +            "description": "First day of this run (YYYY-MM-DD)",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "rule",
      +          "season",
      +          "area",
      +          "access",
      +          "leash",
      +          "starts",
      +          "ends",
      +          "in_days"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "undated": {
      +      "description": "Seasons the source states without dates: not known to apply",
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "access": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "yes",
      +                  "yes_restricted",
      +                  "no"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "area": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "leash": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "rule": {
      +            "description": "The seasonal rule in plain words",
      +            "type": "string"
      +          },
      +          "season": {
      +            "description": "When it runs, in the source's dates: \"July 1 to May 15\"",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "rule",
      +          "season",
      +          "area",
      +          "access",
      +          "leash"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "verified_at": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "date",
      +    "in_season",
      +    "sentence",
      +    "in_effect",
      +    "starts_soon",
      +    "next",
      +    "undated",
      +    "source_url",
      +    "publisher",
      +    "quote",
      +    "verified_at"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / resolved_from
      Added value: +{
      +  "additionalProperties": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "asked": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        ]
      +      },
      +      "used": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "asked",
      +      "used"
      +    ],
      +    "type": "object"
      +  },
      +  "description": "Set when a word was read as the value the tool uses: hotel as lodging, NB as north. Each key is the argument; asked is what was sent, used what it was read as",
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
  2. Changed14 schema fields changedv0.4.0
    • changedInput schema / properties / place / description
      Previous value: -"A city, county or area in California or Nevada, e.g. \"Monterey\", \"South Lake Tahoe\", \"Washoe County, NV\", \"Las Vegas\", \"East Bay\" or \"Lake Tahoe\""New value: +"A city, county, area, region or neighborhood in California or Nevada, e.g. \"Monterey\", \"South Lake Tahoe\", \"Washoe County, NV\", \"Las Vegas\", \"East Bay\", \"Lake Tahoe\", \"Central Valley\" or \"Van Nuys\". Small spelling slips are corrected and the answer says so."
    • removedOutput schema / properties / center / additionalProperties
      Removed value: -{}
    • addedOutput schema / properties / center / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "lat": {
      +        "type": "number"
      +      },
      +      "lon": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "lat",
      +      "lon"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / properties / center / description
      Added value: +"The point searched around; null when the place was not found"
    • removedOutput schema / properties / center / properties
      Removed value: -{
      -  "lat": {
      -    "type": "number"
      -  },
      -  "lon": {
      -    "type": "number"
      -  }
      -}
    • removedOutput schema / properties / center / required
      Removed value: -[
      -  "lat",
      -  "lon"
      -]
    • removedOutput schema / properties / center / type
      Removed value: -"object"
    • addedOutput schema / properties / code
      Added value: +{
      +  "description": "With an outcome other than ok: not_found, invalid, unavailable",
      +  "type": "string"
      +}
    • addedOutput schema / properties / did_you_mean
      Added value: +{
      +  "description": "Close matches to what was asked for: towns, places, slugs or brands, best first",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {},
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / message
      Added value: +{
      +  "description": "What happened, in a sentence",
      +  "type": "string"
      +}
    • addedOutput schema / properties / nearest
      Added value: +{
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "answer": {
      +        "type": "string"
      +      },
      +      "citation": {
      +        "description": "Copy-ready citation: answer, source, date checked, record URL, license",
      +        "type": "string"
      +      },
      +      "confidence": {
      +        "description": "stated: the place's own source says it; inferred_from_agency: an agency-wide rule; inherited_brand: the chain's policy, not confirmed by this hotel",
      +        "enum": [
      +          "stated",
      +          "inferred_from_agency",
      +          "inherited_brand",
      +          "unstated"
      +        ],
      +        "type": "string"
      +      },
      +      "confirmed_by": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "business",
      +              "agency"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "freshness": {
      +        "description": "fresh: inside its review interval; due: past it; stale: past twice it, confirm before you go; unreadable: the last check could not read the source",
      +        "enum": [
      +          "fresh",
      +          "due",
      +          "stale",
      +          "unreadable"
      +        ],
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "record_license": {
      +        "type": "string"
      +      },
      +      "source_urls": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "status": {
      +        "enum": [
      +          "yes",
      +          "yes_restricted",
      +          "no",
      +          "varies",
      +          "unknown"
      +        ],
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      },
      +      "uid": {
      +        "description": "Stable id that survives a rename",
      +        "type": "string"
      +      },
      +      "url": {
      +        "type": "string"
      +      },
      +      "verified_at": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "uid",
      +      "name",
      +      "type",
      +      "status",
      +      "answer",
      +      "citation",
      +      "confidence",
      +      "confirmed_by",
      +      "freshness",
      +      "verified_at",
      +      "url",
      +      "source_urls",
      +      "record_license"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / next
      Added value: +{
      +  "description": "Calls that would answer the question, in words",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / outcome
      Added value: +{
      +  "description": "Absent or ok: a normal answer. no_match: nothing in the data matches, see did_you_mean, nearest and next. bad_input: the arguments cannot be used as given, see next. partial: some of the ids were found, see missing. unavailable: a live source could not be read. None of these is an error.",
      +  "enum": [
      +    "ok",
      +    "partial",
      +    "no_match",
      +    "bad_input",
      +    "unavailable"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / radius_widened_from
      Added value: +{
      +  "description": "Set when the radius asked for held nothing and the search widened",
      +  "type": "number"
      +}
  3. Changed2 schema fields changedv0.2.9
    • changedInput schema / properties / place / description
      Previous value: -"A city or county in California or Nevada, e.g. \"Monterey\", \"South Lake Tahoe\", \"Washoe County, NV\" or \"Las Vegas\""New value: +"A city, county or area in California or Nevada, e.g. \"Monterey\", \"South Lake Tahoe\", \"Washoe County, NV\", \"Las Vegas\", \"East Bay\" or \"Lake Tahoe\""
    • changedInput schema / properties / radius_miles / description
      Previous value: -"Search radius in miles around the town or point"New value: +"Search radius in miles around the town or point (an area is its own boundary; the radius is ignored)"
  4. First observedv0.2.0

TDQS

A4.3/5.0
Behavior5/5

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

Beyond the readOnly/idempotent/non-destructive annotations, it discloses non-obvious runtime behavior: automatic radius widening to 30, 60, then 100 miles with an explicit announcement, spelling-slip correction that is labeled in the answer, and unknown-name responses returning did_you_mean plus nearest towns. It also states what each result carries (dog rule, verified date, source URL), which is genuine behavioral context rather than restated annotation.

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 the core answer, then scope limits, then input contract, then examples — a sensible order with no filler sentences. The example block is somewhat repetitive with the place parameter's own example list, which keeps it from a 5.

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 7-parameter tool with nested objects and an output schema, the description covers everything an agent needs to call it correctly: the place/near choice, filtering intent, fallback behavior when nothing is in radius, and failure handling for unrecognized names. Return-value structure is delegated to the output schema, which is the right division of labor.

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; the description earns an increment by showing the place-vs-near relationship in practice ('near={lat:36.6, lon:-121.9}, radius_miles=5') and by listing how places are actually spoken ('the Mission', 'DTLA', regional names). The place examples duplicate the schema's own examples, so the added value is real but partial.

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 states a concrete outcome: dog-friendly places (beaches, parks, trails, lodging, etc.) in or near a named place, ordered nearest first and grouped by kind. It is clearly more than a restatement of the name, and the closing sentence ('does not check hotels against a dog's weight or a fee budget') carves out scope against hotel-policy tools. It stops short of naming a sibling tool outright, so sibling differentiation is only implicit.

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?

Usage context is explicit: it answers 'dog-friendly things in X' questions, and it declares a boundary condition (no weight/fee-budget checking against hotels). Four worked examples map natural-language questions to concrete argument shapes, including the near={lat,lon} alternative. It does not name which sibling to use for hotel policy or trip planning, so alternatives remain inferred rather than stated.

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