MCP server
Gingr MCP by usefulapi
Read Gingr reservations, owners, pets, check-ins, invoices and timeclock for your…
- Runs
- Remotely
- Version
- 1.31.0
- Listing updated
- 4 days ago
About Gingr MCP by usefulapi
Gingr MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read Gingr reservations, owners, pets, check-ins, invoices and timeclock for your pet-care business.
Install
Run in a terminal
claude mcp add --transport http gingr https://gingr.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://gingr.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gingr": {
"url": "https://gingr.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"gingr": {
"type": "http",
"url": "https://gingr.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gingr": {
"serverUrl": "https://gingr.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gingr": {
"type": "http",
"url": "https://gingr.usefulapi.io/mcp"
}
}
}Tools this server provides (25)
Read directly from the server.
- gingr_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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- Get the estimated cost of an existing (future) reservation. Gingr: GET /api/v1/existing_reservation_estimate.
- gingr_list_owners
- 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
- 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
- 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
- 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
- Get the immunization (vaccination) records of one animal, with expiration dates. Gingr: GET /api/v1/get_animal_immunizations.
- gingr_get_animal_feeding
- Get the feeding information of one animal (food, amounts, schedule). Gingr: GET /api/v1/get_feeding_info.
- gingr_get_animal_medications
- Get the medication information of one animal (medications, doses, schedule). Gingr: GET /api/v1/get_medication_info.
- gingr_list_invoices
- 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
- 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
- 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
- Get one subscription (membership package) by id. Gingr: GET /api/v1/get_subscription.
- gingr_get_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
- List recently uploaded report card files (photos and videos shared with pet parents), newest first. Gingr: GET /api/v1/report_card_files.
Gingr MCP by usefulapi FAQ
How do I add Gingr MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http gingr https://gingr.usefulapi.io/mcp