Read Gingr reservations, owners, pets, check-ins, invoices and timeclock for your pet-care business. Hosted by usefulapi — connect from Claude, Cursor, or any MCP client.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"gingr": {
"url": "https://gingr.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
gingr_list_locations | read | List locations List the locations (facilities) of this Gingr app, as id (value) + name (label). Good first call: most other tools take a location_id. Gingr: GET /api/v1/get_locations. |
gingr_list_reservation_types | read | List reservation types List the reservation types (services such as boarding, daycare, grooming, training) with their ids. Use the ids to filter reservations or to read a type's add-on services. Gingr: GET /api/v1/reservation_types. |
gingr_list_services_by_type | read | List add-on services of a reservation type List the additional services (add-ons) allowed for a reservation type, e.g. baths or nail trims on a boarding stay. Gingr: GET /api/v1/get_services_by_type. |
gingr_list_reference | read | List reference data List one kind of reference data of this Gingr app: species, breeds, temperaments, vets (veterinarians with details), retail_items (retail items for sale) or immunization_types (of one species; needs species_id). Paged. Gingr: GET /api/v1/get_species | get_breeds | get_temperaments | get_vets | get_all_retail_items | get_immunization_types. |
gingr_list_reservations | read | List reservations in a date range List all reservations (boarding, daycare, grooming, training…) between two dates, at most 30 days apart (Gingr's limit). Paged: total, next_offset, items. Gingr: POST /api/v1/reservations (checked_in=false). |
gingr_list_checked_in | read | List pets checked in now List the reservations that are checked in right now (the pets currently on site). Paged. Gingr: POST /api/v1/reservations (checked_in=true). |
gingr_get_daily_summary | read | Get the day's check-in / check-out summary Get the summary of reservations for one date: number of check-ins, check-outs and overnights (the widget at the top of the Gingr dashboard). Gingr: GET /api/v1/reservation_widget_data. |
gingr_get_whiteboard | read | Get today's arrivals and departures (whiteboard) Get the pets checking in and checking out today at a location, by reservation type, with owner/pet names, times, run and status (Gingr's Digital Whiteboard). Gingr: GET /api/v1/back_of_house. |
gingr_list_owner_reservations | read | List an owner's reservations List the reservations of one owner (customer), optionally only pending requests, current, future, past or wait-listed ones, by dates, types or pets. Only the location the API user is logged into is included (Gingr). Gingr: POST /api/v1/reservations_by_owner. |
gingr_list_animal_reservations | read | List a pet's reservations 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. |
gingr_list_cancelled_reservations | read | List recently cancelled reservations List the reservations that were cancelled between two dates (at most 31 days apart). Paged. Gingr: POST /api/v1/recently_cancelled_reservations. |
gingr_get_reservation_estimate | read | Get a reservation's cost estimate Get the estimated cost of an existing (future) reservation. Gingr: GET /api/v1/existing_reservation_estimate. |
gingr_list_owners | read | List owners (customers) List owners (pet parents / customers) with contact details, balance and reservation counts, optionally filtered by exact first/last name, email, cell phone, ZIP or home location. Paged. Gingr: GET /api/v1/owners (filters as params[<field>]). Passwords and payment-card references are removed. |
gingr_get_owner | read | Get an owner Get one owner (customer) record by exactly one of: owner id, one of their pets' id, one of their reservations' id, cell phone or email. Gingr: GET /api/v1/owner. Passwords and payment-card references are removed. |
gingr_list_new_modified_owners | read | List new or changed owners List the owners (customers) created or modified between two dates (at most 366 days apart). Paged. Gingr: POST /api/v1/new_modified_owners. |
gingr_list_animals | read | List animals (pets) List animals (pets) with species, breed, birthday, weight, owner and notes, optionally filtered by owner, exact name, species or breed. Paged. Gingr: GET /api/v1/animals (filters as params[<field>]). |
gingr_get_animal_immunizations | read | Get a pet's immunization records Get the immunization (vaccination) records of one animal, with expiration dates. Gingr: GET /api/v1/get_animal_immunizations. |
gingr_get_animal_feeding | read | Get a pet's feeding instructions Get the feeding information of one animal (food, amounts, schedule). Gingr: GET /api/v1/get_feeding_info. |
gingr_get_animal_medications | read | Get a pet's medications Get the medication information of one animal (medications, doses, schedule). Gingr: GET /api/v1/get_medication_info. |
gingr_list_invoices | read | List invoices or estimates List invoices (complete=true) or estimates (complete=false, Gingr's default) created on or after 2019-08-01, optionally closed only and by date range. Paged by Gingr: per_page + start (the 1-based number of the first result; the next page starts at start + per_page). Gingr: GET /api/v1/list_invoices. |
gingr_get_transaction | read | Get a POS transaction Get one point-of-sale transaction with its items and payment details (card numbers, processor references and auth codes are removed). Gingr: POST /api/v1/transaction. |
gingr_list_subscriptions | read | List subscriptions (packages) List recurring subscriptions (membership packages), optionally of one owner, location or package, by billing day, including cancelled ones if asked. Paged by Gingr (limit + offset). Gingr: GET /api/v1/get_subscriptions. |
gingr_get_subscription | read | Get a subscription Get one subscription (membership package) by id. Gingr: GET /api/v1/get_subscription. |
gingr_get_timeclock_report | read | Get the staff timeclock report Get staff timeclock records (clock-ins/outs, hours) at a location between two dates (at most 31 days apart). Gingr: GET /api/v1/timeclock_report. |
gingr_list_report_card_files | read | List recent report card files List recently uploaded report card files (photos and videos shared with pet parents), newest first. Gingr: GET /api/v1/report_card_files. |
gingr_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
gingr_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Gingr tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Does not count against the meter. | |
gingr_cancel_subscription | Cancel the Pro subscription Cancel the caller's Gingr Pro subscription at the end of the paid period (no refund for the current period; unlimited calls continue until then, then the free tier applies). Requires confirm: true. Run gingr_upgrade later to undo the cancel before the period ends. Does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Proper Gingr business | $9/mo · $90/yr | Unlimited |
Pro covers this Gingr server only. Subscribe with gingr_upgrade (it returns a Stripe Checkout link). Cancel any time with gingr_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running gingr_upgrade before then undoes the cancel. Or write to [email protected].
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.