# Gingr MCP by usefulapi

> Gingr MCP by usefulapi is an MCP server. Read Gingr reservations, owners, pets, check-ins, invoices and timeclock for your pet-care business. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/gingr/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/gingr
- **MCP Registry name:** io.usefulapi/gingr
- **Listing updated:** 2026-11-13

## About

Read Gingr reservations, owners, pets, check-ins, invoices and timeclock for your pet-care business.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gingr https://gingr.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gingr.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gingr": {
      "url": "https://gingr.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gingr": {
      "type": "http",
      "url": "https://gingr.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gingr": {
      "serverUrl": "https://gingr.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gingr": {
      "type": "http",
      "url": "https://gingr.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/gingr-mcp-by-usefulapi
