[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# RunLoyal API and MCP server: Let your AI agent handle the front desk paperwork.

> RunLoyal publishes Partner API documentation at api.runloyal.com. Its endpoints follow the pet owner booking flow: sign-in, pets, immunizations, appointments, invoices, gift cards and rewards. How a business gets credentials is not stated, and no RunLoyal MCP server or official ChatGPT or Claude connector was found.

RunLoyal's Partner APIs cover the pet owner booking flow, and no RunLoyal MCP server was found (checked 17 Nov 2026). Cotlet runs a hosted RunLoyal MCP server with 40 tools that ChatGPT and Claude use in your own Business Portal. Report cards, messages, bookings and refunds wait for your OK.

- Free 7-day trial, no card
- Unofficial, not affiliated with RunLoyal
- Page: https://cotlet.dev/integrations/runloyal-api-mcp-server

> Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by RunLoyal. RunLoyal is a trademark of its owner. If RunLoyal's own integrations cover what you need, use them first.

## What can your AI agent do in RunLoyal?

- Plan tomorrow's rooms and staffing
- Send the afternoon report cards
- Quote and book a stay
- Chase vaccinations that need review
- Win back members not on auto renew
- Send a birthday campaign with a coupon

## Does RunLoyal have an MCP server or an API?

- The Partner APIs have no endpoints for check-in, report cards, Message Hub, Push Marketing, staff timesheets or Paw Metrics.
- RunLoyal's FAQ names Zapier and Mailchimp integrations and its own Push Marketing.
- Scout AI is RunLoyal's built-in AI for report card notes, messages, photos and scheduling trends; Vax Verify is a paid add-on.

| What you need | Partner API | By hand | Cotlet |
|---|---|---|---|
| Book stays and manage pet profiles | Pet owner side, partner access | At the desk | Writes after your OK |
| Check-ins, report cards and messages | Not in the API | One pet at a time | Drafted, sent after your OK |
| Paw Metrics, timesheets and settings | Not in the API | Screen by screen | 40 tools in all |
| Ask ChatGPT or Claude to do the work | No MCP server found | Copy and paste | Hosted MCP server |

Checked 17 Nov 2026. Sources: [RunLoyal Partner APIs](https://api.runloyal.com/), [RunLoyal FAQ](https://www.runloyal.com/faqs/), [RunLoyal knowledge base](https://support.runloyal.com/support/solutions), [KB: Using the Pet Count Dashboard](https://support.runloyal.com/support/solutions/articles/154000215077-using-the-pet-count-dashboard), [KB: Sending Report Cards](https://support.runloyal.com/support/solutions/articles/154000238058-sending-report-cards), [KB: Creating and Managing Appointments](https://support.runloyal.com/support/solutions/articles/154000215070-creating-managing-appointments), [KB: View estimate](https://support.runloyal.com/support/solutions/articles/154000262098-view-estimate), [KB: Vax Verify in Business Portal](https://support.runloyal.com/support/solutions/articles/154000254763-vax-verify-in-business-portal), [KB: Push Marketing](https://support.runloyal.com/support/solutions/articles/154000238183-push-marketing-app-email-sms-campaigns-), [KB: Membership Reporting](https://support.runloyal.com/support/solutions/articles/154000217369-membership-reporting)

## How does the RunLoyal MCP server work?

1. **Sign in to RunLoyal.** Once, in a browser we host for you.
2. **Connect your AI agent.** One address in its settings.
3. **Hand it the desk work.** Quote a stay, then approve the booking.

Your agent works in your own signed-in Cloud Browser. Anything a pet owner receives or pays waits for your OK.

## How to connect RunLoyal to your AI agent

1. **Sign in to RunLoyal in a Cloud Browser.** Open your RunLoyal Business Portal in your Cotlet Cloud Browser and sign in with your own staff user.
2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. **Let the agent in.** Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

RunLoyal is served from the shared address `https://cotlet.dev/mcp/v1`, the same one as every other app you turn on. Added RunLoyal later? Refresh the connector to pick up its 40 tools.

ChatGPT:

```
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
```

Claude:

```
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

Cursor:

```
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
```

Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

n8n:

```
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: runloyal_read
```

## All 40 RunLoyal MCP tools

One tool per workflow in the RunLoyal knowledge base. Dashboards, reports and links only read; everything else writes and asks first.

### Today and tomorrow

Pet counts by service, the calendar with lodging rooms, run cards from the To-Do tab and the Digital Wall queue.

- **Read the pet count** (`view_pet_count`, read): Read the Pet Count dashboard for a day, for all services or one.
- **Read the calendar** (`view_calendar`, read): Read the calendar: capacity services by day and lodging stays by room.
- **Print run cards** (`get_run_cards`, read): Get today's full run cards from the To-Do tab as a printable file.
- **Read the Digital Wall** (`view_digital_wall`, read): Read the pets queued on the Digital Wall for drop-off or pickup.
- **Plan transport routes** (`plan_transport_route`, write, asks first): Read the optimized route for the day's pet transport services.

### Bookings and stays

Estimates with the real pricing rules, appointments, check-in and out, room moves, feeding and medication, staff notes and incidents.

- **View estimates** (`view_estimate`, read): Get the expected price of an appointment before booking it.
- **Create appointments** (`manage_appointments`, write, asks first): List appointments, or create or edit one for one or more pets of a family.
- **Check pets in and out** (`check_in_out`, write, asks first): Check in a confirmed appointment, with belongings and notes, or check it out.
- **Move pets between rooms** (`move_room`, write, asks first): Move a checked-in lodging appointment to another room, for some or all days.
- **Record feeding and medication** (`record_feeding_medication`, write, asks first): Read or set a pet's feeding and medication schedule for its stay.
- **Add appointment staff notes** (`add_staff_note`, write, asks first): Add or pin an internal staff note on an appointment.
- **Record incidents** (`record_incident`, write, asks first): Add an incident to a pet's profile with its incident type and details.

### Pets and pet owners

Pet and owner profiles, Vax Verify review, agreement requests, tags with alerts and training homework.

- **Manage pets** (`manage_pets`, write, asks first): List, add, edit or remove pets on a pet owner's profile.
- **Manage pet owners** (`manage_pet_owners`, write, asks first): List, add, edit or block pet owners.
- **Verify vaccinations** (`verify_vaccinations`, write, asks first): Review vaccination records scanned by Scout AI Vax Verify and confirm or fix them.
- **Send agreement requests** (`send_agreement_request`, write, asks first): Request that a pet owner sign one or more agreements.
- **Set pet tags and alerts** (`manage_pet_tags`, write, asks first): Create pet or owner tags, assign them and turn on tag-based alerts.
- **Assign training homework** (`manage_curriculum`, write, asks first): Create a training curriculum with practices and homework.

### Messages and marketing

Report cards, Message Hub, Push Marketing campaigns, review requests, booking links and the rewards program.

- **Send report cards** (`send_report_card`, write, asks first): Create and send a report card for one pet or in bulk.
- **Message pet owners** (`send_message`, write, asks first): Send a pet owner a message from Message Hub, by app or SMS.
- **Send Push Marketing campaigns** (`send_campaign`, write, asks first): Send an email, app or SMS campaign to a segment of pet owners.
- **Request reviews** (`manage_reviews`, write, asks first): Read internal reviews or turn on Request review for an appointment.
- **Get booking links and QR codes** (`get_web_links`, read): Get your website booking link, universal app link and app QR code.
- **Set rewards and loyalty** (`manage_rewards`, write, asks first): Read or set how pet owners earn and redeem loyalty points.

### Money: invoices, memberships and retail

Open invoices, refunds, tips, coupons, packages, memberships, e-gift cards and retail products. Everything here changes what owners pay.

- **Read open invoices** (`view_open_invoices`, read): List open invoices and read one by number.
- **Refund invoices** (`refund_invoice`, write, asks first): Refund items with their payment, or only the payment, on an invoice.
- **Set tips** (`manage_tips`, write, asks first): Read or set tip choices: percent or dollar, quick picks and calculation.
- **Create coupons** (`manage_coupons`, write, asks first): Create a coupon or apply one to an invoice.
- **Set up packages** (`manage_packages`, write, asks first): List or create packages with credits for daycare, boarding or add-ons.
- **Enroll memberships** (`manage_memberships`, write, asks first): Enroll a pet owner in a membership, or pause or cancel one.
- **Sell e-gift cards** (`manage_gift_cards`, write, asks first): Sell an e-gift card to a pet owner's account or apply one to an invoice.
- **Add and sell retail products** (`manage_retail_products`, write, asks first): Add a retail product with its UPC, or add one to a Quick Checkout invoice.

### Reports and setup

Paw Metrics, membership and owner reports, timesheets, services, Dynamic Pricing, staff groups and business hours.

- **Run Paw Metrics reports** (`run_paw_metrics_report`, read): Run any Paw Metrics report your staff group may see, for a date range.
- **Read membership reports** (`view_membership_report`, read): Read the Membership Details report, for example members not on auto renew.
- **Export pet owner details** (`export_pet_owner_details`, read): Run the Pet Owner Details report in Paw Metrics and download it.
- **Edit timesheets** (`edit_timesheets`, write, asks first): Read staff clock in and out, breaks and hours, or correct an entry.
- **Set up services** (`manage_services`, write, asks first): List service categories and services, or create a lodging-based service.
- **Set dynamic pricing** (`manage_dynamic_pricing`, write, asks first): List or add Dynamic Pricing rules by booking days and capacity.
- **Set staff groups** (`manage_staff_groups`, write, asks first): List staff groups or create one with its sections, actions and reports.
- **Set business hours** (`manage_business_hours`, write, asks first): Read or set Global Business Hours and closed days.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/runloyal-api-mcp-server#tools

## Who can see my RunLoyal session, and how do I revoke it?

- **What we store.** Your signed-in RunLoyal browser profile, AES-256-GCM encrypted, in Finland. Never your password.
- **What your agent gets.** The 40 RunLoyal tools. The session cookie stays in the Cloud Browser.
- **What the session sees.** The pets, owners, bookings and reports your staff group may open.
- **What no tool touches.** Payment processing and card terminals, your RunLoyal subscription and add-ons, the Zapier and Mailchimp connections, staff users.
- **If RunLoyal signs you out.** You sign in again yourself, in the same Cloud Browser.
- **How to cut access.** Disable RunLoyal for agents, reset the browser, or change your RunLoyal password.

Cotlet never sees or stores your password: you type it in yourself, and from then on the agent uses only the session. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)).

## Approvals, undo and mistakes

1. **Get the estimate.** view_estimate uses your pricing rules.
2. **Check the calendar.** Free rooms for the dates.
3. **Show you the booking.** Pet, service, dates and add-ons.
4. **Book after your OK.** manage_appointments creates the stay.

| Action | How to put it right |
|---|---|
| Appointment dates or room | Call manage_appointments or move_room again with the right values |
| Pet details, tags, feeding | Update them again with the same tool |
| Report card, message or campaign | Already delivered: follow up with the owners |
| Refund | Money is back with the owner: charge again only with their agreement |

All 30 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 10 read tools, counts, calendar, reports and links, run at once.

MCP call:

```
{
  "name": "manage_appointments",
  "arguments": {
    "action": "create",
    "owner": "Example Owner",
    "pets": [
      "Biscuit"
    ],
    "service": "Overnight Boarding Standard Suite",
    "start": "2026-11-21",
    "end": "2026-11-25",
    "add_ons": [
      "Exit bath"
    ]
  }
}
```

REST:

```
curl -X POST https://cotlet.dev/api/v1/runloyal/appointments/manage \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"create","owner":"Example Owner","pets":["Biscuit"],"service":"Overnight Boarding Standard Suite","start":"2026-11-21","end":"2026-11-25","add_ons":["Exit bath"]}'
```

Response:

```
{
  "appointment": "APT-48211",
  "owner": "Example Owner",
  "pets": [
    "Biscuit"
  ],
  "service": "Overnight Boarding Standard Suite",
  "start": "2026-11-21",
  "end": "2026-11-25",
  "status": "Confirmed"
}
```

The example books Biscuit into a standard suite from 21 to 25 November with an exit bath. A cron job or n8n flow can make the same call over REST at `/api/v1/runloyal` with the same key and price, in JSON. Failed calls are free.

## How much does the RunLoyal MCP server cost?

**About $21 a month** for a pet resort with boarding, daycare and grooming, 3,620 credits. Your RunLoyal plan stays as it is.

| Job | Calls | Credits |
|---|---|---|
| Evening pet count and free rooms | 2 × 30 | 600 |
| Daycare report cards, sent in bulk | 2 × 22 | 440 |
| Stays quoted and booked | 2 × 40 | 800 |
| Vaccination review and owner messages | 6 × 4 | 240 |
| Membership and birthday campaigns | 4 × 1 | 40 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 212 calls | 3,620 |

The smallest pack, 5,000 credits for $29, covers this month. Holiday season brings more stays and more calls.

- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Your RunLoyal plan, add-ons and staff group apply as they are

Credit packs are paid once, not monthly. The month above is our own estimate of a resort's workload, not measured usage.

## RunLoyal MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| RunLoyal Partner APIs | Pet owner sign-in, pets, bookings, invoices, gift cards and rewards. | No front desk, report card, messaging or reporting endpoints; credentials through RunLoyal. |
| Zapier integration | Connects RunLoyal to other tools, set up per RunLoyal's knowledge base. | Whatever triggers and actions the Zapier app offers. |
| Mailchimp integration | More advanced campaign work in Mailchimp. | Marketing only. |
| Scout AI | RunLoyal's built-in AI for notes, messages and photos. | Inside RunLoyal, not your ChatGPT or Claude. |

If you build a booking app as a RunLoyal partner, the Partner APIs are the route. Cotlet fits when ChatGPT, Claude or a script should do the front desk and owner work in RunLoyal, from your own login, with nothing to host.

## Who runs Cotlet

Cotlet is a product of Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), in business since 2019, with Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing) as founders. Questions about the RunLoyal tools: contact@cotlet.dev.

## RunLoyal MCP server: questions

### How do I get access?

Sign up free at https://cotlet.dev/signup?app=runloyal, turn on RunLoyal under Integrations in the console and sign in to your RunLoyal Business Portal in your Cloud Browser. Then connect your AI agent and ask for tomorrow's pet count. The trial needs no card.

### Does RunLoyal have an API?

RunLoyal publishes Partner API documentation at api.runloyal.com; it covers the pet owner booking flow, and how a business gets credentials is not stated. RunLoyal also connects to Zapier and Mailchimp. No RunLoyal MCP server or official ChatGPT or Claude connector was found (checked 17 Nov 2026). Cotlet works in your own signed-in Business Portal instead.

### How is this different from Scout AI?

Scout AI is RunLoyal's own AI inside the platform: report card notes and messages, photo enhancement and scheduling trends, with Vax Verify as a paid add-on. Cotlet lets ChatGPT, Claude or your script work across the Business Portal with the same tools over MCP or REST.

### Do add-on features work through Cotlet?

Only if your RunLoyal account has them. Memberships, Dynamic Pricing, Vax Verify, Route Optimizer and SMS are add-ons; their tools work only when RunLoyal has enabled them for you.

### Which RunLoyal user should I sign in with?

A staff user in the group whose work the agent should do. Staff groups decide which sections, actions and reports a user sees, and the agent sees the same. Admin and Staff are RunLoyal's default groups.

### Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 40 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

### Is Cotlet affiliated with RunLoyal?

No. Cotlet is independent and not affiliated with RunLoyal.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.
