# Gingr MCP

> Gingr MCP lets your agent manage pet care data by pulling owner profiles, tracking reservations for grooming or boarding, and viewing real-time facility check-ins. Stop clicking through multiple dashboards; just ask your agent to give you a full picture of any client's history.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** pet-care, daycare-management, grooming, reservations, facility-management

## Description

Need to know everything about a pet client in one conversation? This MCP connects your pet care management account directly to your AI client, letting you pull data without ever logging into the Gingr dashboard. It handles owner profiles, tracks all their past and future bookings—like grooming or daycare stays—and gives you a live look at which rooms are occupied right now. You can find an owner using just an email address or phone number, pulling up full pet records instantly. If your job involves customer service or operations, this MCP is built for you. By connecting through Vinkius, you get access to all of Gingr's data sources in one place, allowing your agent to answer complex questions, like 'How many pets are currently checked into the Blue Room?' using simple conversational commands.

## Tools

### verify_api_connection
Checks if the connection to your pet care database is active and working.

### list_active_checkins
Lists the pets currently checked into the facility for care or boarding.

### find_owner_by_email
Looks up a pet owner’s profile using their email address.

### get_pet_owner_details
Retrieves all information available on an owner's profile.

### find_owner_by_phone
Finds an owner's details by entering their phone number.

### get_digital_whiteboard
Displays the current, active whiteboard status for a facility location.

### list_business_locations
Provides a list of all pet care facilities and business locations configured in your account.

### list_owner_reservations
Shows all past or future bookings for an owner, including boarding and grooming dates.

### search_pet_custom_fields
Searches for specialized or internal metadata fields associated with pets.

### search_owner_custom_fields
Searches for specific, custom data points related to pet owners.

## Prompt Examples

**Prompt:** 
```
Find pet owner details for 'john@email.com'.
```

**Response:** 
```
Retrieving owner... I found a profile for John Doe. He has one pet named 'Buddy' (Golden Retriever) and his last check-in was yesterday.
```

**Prompt:** 
```
List all future reservations for owner ID '12345'.
```

**Response:** 
```
Fetching reservations... Owner 12345 has 2 upcoming bookings: a 3-day boarding stay starting next Friday and a grooming session on Monday.
```

**Prompt:** 
```
Show me the current digital whiteboard for location '1'.
```

**Response:** 
```
Retrieving whiteboard... In location 1, there are currently 12 pets checked-in for daycare and 5 for boarding. 3 pets are currently assigned to the 'Blue Room'.
```

## Capabilities

### Identify pet owners
Find a pet owner’s complete profile details using their email or phone number.

### Track reservation history
Get a list of all past and upcoming bookings for any specific owner.

### View facility activity
See which rooms are occupied or which pets are currently checked into the facility in real time.

### Search custom records
Look up pet or owner data using specialized, non-standard metadata fields.

### List business sites
Pull a list of all physical locations and facilities associated with your account.

## Use Cases

### Handling a new client emergency visit
A vet calls needing to confirm an owner’s pet history. Instead of manually calling three different systems, the agent runs `find_owner_by_email` to get the profile, then uses `get_pet_owner_details` to pull all pet records in one go.

### Preparing for a large group boarding check-in
The operations team needs to know exactly who is staying and where. They run `list_active_checkins` first, then use the whiteboard tool to verify which rooms are assigned that day.

### Checking a client's long-term pet care plan
A customer calls asking about past services. The agent runs `list_owner_reservations` and can filter for specific activities, like grooming or boarding stays from three months ago.

### Auditing facility readiness before opening
The manager needs a full overview of the business day's capacity. They call `list_business_locations` to confirm which sites are operating, then use `get_digital_whiteboard` for real-time staffing and occupancy counts.

## Benefits

- Instant Owner Lookup: Instead of navigating to a search page, you just ask your agent for details using `find_owner_by_email` or `find_owner_by_phone`, getting the full profile instantly.
- Full Booking View: You never miss an appointment detail. Use `list_owner_reservations` to see every single future and past booking in one go, whether it's for daycare or grooming.
- Real-Time Oversight: Need to know who's on site right now? Calling `get_digital_whiteboard` gives you a live picture of room assignments and active check-ins without opening the dashboard.
- Deep Data Search: Don't find what you need because it lives in an obscure field. Use `search_owner_custom_fields` or `search_pet_custom_fields` to pull specific internal attributes.
- Location Clarity: If your company has multiple sites, start by calling `list_business_locations`. You can then drill down into any single facility's activity using the whiteboard tool.

## How It Works

The bottom line is you talk naturally to your agent, and it gets the structured data back from Gingr.

1. Subscribe to this MCP on Vinkius, then enter your Gingr Subdomain and API Key.
2. Authorize your AI client to access the pet care database via the Model Context Protocol.
3. Ask your agent a question—for example, 'What are John Doe's reservations for next month?'—and it pulls the answer.

## Frequently Asked Questions

**How do I get an API Key for Gingr?**
Log in to Gingr, navigate to Reports & More > Users, edit your user, and look for the 'API Keys' section to generate or copy your key.

**Can I create new reservations via the agent?**
No, the current Gingr Public API is read-only. This integration is designed for safely retrieving and auditing your existing data.

**How do I find my Location ID?**
Use the 'list_business_locations' tool. The agent will return all configured locations in your app along with their unique IDs.

**Is the Digital Whiteboard data live?**
Yes, all data retrieved through the 'get_digital_whiteboard' tool is fetched directly from the Gingr API, reflecting the current state of your facility.

**What does `verify_api_connection` confirm about my access permissions?**
It confirms that your agent has read-only data visibility. This means the AI can pull information—like owner profiles or check-ins—but it cannot make any changes to the system.

**If I run `search_owner_custom_fields`, how does the agent handle missing metadata?**
The agent reports null if no custom data is found for that owner or pet. It won't throw an error; it just tells you nothing was located in those specific fields.

**Are there rate limits when using `list_owner_reservations` across many owners?**
The system enforces standard API rate limits to prevent overload. If you query too many reservations quickly, your agent will receive an explicit limit error message.

**When I use `find_owner_by_email`, what specific formats are required for the email address?**
The email must be provided in a standard format (e.g., name@domain.com). The agent requires a valid, active string to successfully locate an owner profile.