Skip to main content
Glama
DogPolicies MCP Server

DogPolicies MCP Server

by xultrax-web

Compare places side by side

dogpolicies_compare_places
Read-onlyIdempotent

Compare dog policies for two to six places side by side to check leash rules, pet fees, weight limits, and restrictions, with verified sources and freshness for each fact.

Instructions

Which of these places is better for my dog: Carmel Beach or Asilomar, two parks, three hotels? Sets two to six known places side by side, fact by fact. Input: ids from search results ("carmel-beach", "asilomar-state-beach"); an exact name or a near miss resolves to the one clear match. Returns one row per fact (dogs allowed, leash rule, where dogs may go, pet fee, weight limit, pets per room, restrictions) and one column per place, with confidence, freshness, who confirmed it, and a citation for each. An id that matches nothing is listed under missing with close matches while the rest are still compared (outcome partial); fewer than two found is no_match with suggestions.

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": {
      "ids": "<ids>"
    },
    "name": "dogpolicies_compare_places"
  }
}

Input Schema

NameRequiredDescriptionDefault
idsYesTwo to six place ids from search results
response_formatNo'markdown' for readable text, 'json' for structured datamarkdown

Output Schema

NameRequiredDescriptionDefault
codeNoWith an outcome other than ok: not_found, invalid, unavailable
nextNoCalls that would answer the question, in words
rowsYes
as_ofYesDate the data was built (YYYY-MM-DD)
placesYes
licenseYes
messageNoWhat happened, in a sentence
missingNoIds nothing matched, each with its close matches
nearestNoWhen nothing is inside the radius: the nearest places in the data, with distance_miles
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
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

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.5.0
    • 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 / 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 / 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 / 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 / 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. Changed7 schema fields changedv0.4.0
    • 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 / missing
      Added value: +{
      +  "description": "Ids nothing matched, each with its close matches",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {
      +      "id": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / nearest
      Added value: +{
      +  "description": "When nothing is inside the radius: the nearest places in the data, with distance_miles",
      +  "items": {
      +    "additionalProperties": {},
      +    "properties": {},
      +    "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"
      +}
  3. First observedv0.2.0

TDQS

A4.2/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, and an output schema exists. The description still earns credit for disclosing the partial/no_match failure modes and the per-fact confidence, freshness, confirmer and citation metadata, but it spends most of its length on the return shape the output schema already covers.

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 use case and then the mechanics in a sensible order (input, output, edge cases). The opening rhetorical question with 'Carmel Beach or Asilomar, two parks, three hotels' is illustrative rather than load-bearing and could be trimmed.

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?

With 2 params, full schema coverage, an output schema and annotations, the definition covers input provenance, cardinality bounds, result layout and degraded outcomes (partial, no_match with suggestions). Nothing an agent needs to call or interpret it is missing.

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, and the description goes beyond it by explaining that ids are drawn from search results and that an exact name or near miss resolves to the one clear match — real semantics about id tolerance that the schema does not express.

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?

"Sets two to six known places side by side, fact by fact" gives a concrete verb, resource and scope, and the note that ids come from search results distinguishes it from the search and single-place siblings without needing 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?

It establishes the precondition (two to six *known* places, ids from search results, with name/near-miss resolution) so an agent can tell it must search first and must have multiple candidates. It never explicitly says when to prefer get_place or search_places instead, so the routing is implied rather than stated.

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