Skip to main content
Glama

Gingr MCP by usefulapi

List a pet's reservations

gingr_list_animal_reservations
Read-only

List the reservations of one animal (pet), optionally only pending requests, current, future, past or wait-listed ones, by dates or types. Only the location the API user is logged into is included (Gingr). Gingr: POST /api/v1/reservations_by_animal.

Input Schema

NameRequiredDescriptionDefault
limitNoReturn at most this many reservations (1-200, default 50).
to_dateNoOnly reservations up to this date (YYYY-MM-DD).
animal_idYesAnimal (pet) id (from gingr_list_animals).
from_dateNoOnly reservations from this date (YYYY-MM-DD).
animal_idsNoOnly these animal (pet) ids.
restrict_toNoOnly reservations in this state.
cancelled_onlyNotrue = only cancelled reservations.
completed_onlyNotrue = only completed reservations.
confirmed_onlyNotrue = only confirmed reservations.
reservation_type_idsNoOnly these reservation type ids (from gingr_list_reservation_types).

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint and openWorldHint, so the safety profile is covered. The description adds a real behavioral constraint not in the annotations: only data for the location the logged-in API user belongs to is returned, which materially affects the result set. It also exposes the underlying endpoint, but says nothing about pagination beyond the limit parameter.

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?

Two tightly written sentences front-load the core action and filters, followed by the location constraint and API endpoint. Nothing is redundant, though the raw endpoint line is marginal value for an agent.

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 read-only list tool with 10 fully documented parameters and no output schema, the description covers the resource, filters, and the important location-scoping caveat. Return shape and pagination behavior are the only notable gaps, and with no output schema they are minor.

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?

Schema description coverage is 100%, so every parameter is already documented in the schema. The description's mentions of states and 'by dates or types' loosely map to restrict_to, from_date/to_date, and reservation_type_ids but add no syntax or format detail beyond the schema. Baseline 3 is appropriate.

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?

States a specific verb and resource ('List the reservations of one animal (pet)') with clear scope, which implicitly separates it from the broader gingr_list_reservations and gingr_list_owner_reservations. It does not name those siblings explicitly, so it falls just short of the top band.

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

Usage Guidelines3/5

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

The description sketches what kinds of filtering are available ('optionally only pending requests, current, future, past or wait-listed ones, by dates or types'), which implies usage. However, it never says when to choose this tool over gingr_list_reservations, gingr_list_owner_reservations, or gingr_list_cancelled_reservations, leaving routing to inference.

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.