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

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

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.

RunLoyal Cloud Browser

40 tools Read and write

Pet care business work

What can your AI agent do in RunLoyal? The desk work around boarding, daycare and grooming.

  • 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

Partner API, no MCP

Does RunLoyal have an MCP server or an API? The official RunLoyal routes, checked 17 November 2026.

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.

  • 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.
The RunLoyal Partner API, working by hand and Cotlet compared
What you need Partner APIBy handCotlet
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 · RunLoyal FAQ · RunLoyal knowledge base · KB: Using the Pet Count Dashboard · KB: Sending Report Cards · KB: Creating and Managing Appointments · KB: View estimate · KB: Vax Verify in Business Portal · KB: Push Marketing · KB: Membership Reporting

Set up once

How does the RunLoyal MCP server work? The RunLoyal MCP server by Cotlet: your agent works in your own Business Portal.

  1. 1Sign in to RunLoyal

    Once, in a browser we host for you.

  2. 2Connect your AI agent

    One address in its settings.

  3. 3Hand 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. Who can see your session

Any MCP client

How to connect RunLoyal to your AI agent

  1. 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. 2

    Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.

  3. 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
10 read, 30 write

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 tomorrow5

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

  • view_pet_count Read the Pet Count dashboard for a day, for all services or one. read

    Returns the pets per service for the day. Switch days to compare.

    MCP callrunloyal_read → view_pet_count

    REST endpointGET https://cotlet.dev/api/v1/runloyal/pet-counts/view

    Parameters

    Parameters: view_pet_count
    NameTypeDescription
    date string string ISO date. Defaults to today.
    service string string Isolate one service, for example Daycare.

    Example response

    {
      "date": "2026-11-18",
      "counts": [
        {
          "service": "Boarding",
          "pets": 34
        },
        {
          "service": "Daycare",
          "pets": 41
        },
        {
          "service": "Grooming",
          "pets": 9
        }
      ]
    }
  • view_calendar Read the calendar: capacity services by day and lodging stays by room. read

    Lodging shows incoming and outgoing dogs per room, so you can see where a room frees up.

    MCP callrunloyal_read → view_calendar

    REST endpointGET https://cotlet.dev/api/v1/runloyal/calendars/view

    Parameters

    Parameters: view_calendar
    NameTypeDescription
    section string required string One of `capacity`, `lodging`.
    date string string ISO date. Defaults to today.
    view string string Occupied rooms or all rooms.

    Example input

    {
      "section": "section"
    }

    Example response

    {
      "section": "lodging",
      "date": "2026-11-18",
      "rooms": [
        {
          "room": "Suite 4",
          "pet": "Biscuit",
          "out": "2026-11-20"
        },
        {
          "room": "Suite 5",
          "pet": null
        }
      ]
    }
  • get_run_cards Get today's full run cards from the To-Do tab as a printable file. read

    Returns the run cards for printing. It changes nothing.

    MCP callrunloyal_read → get_run_cards

    REST endpointGET https://cotlet.dev/api/v1/runloyal/run-cards

    Parameters

    Parameters: get_run_cards
    NameTypeDescription
    status string string One of `all`, `confirmed`, `checked_in`.
    pets array array Only these pets.

    Example response

    {
      "run_cards": 27,
      "file": "run-cards-2026-11-18.pdf"
    }
  • view_digital_wall Read the pets queued on the Digital Wall for drop-off or pickup. read

    The same list the front desk sends to the staff TV.

    MCP callrunloyal_read → view_digital_wall

    REST endpointGET https://cotlet.dev/api/v1/runloyal/digital-walls/view

    Parameters

    No parameters.

    Example response

    {
      "queue": [
        {
          "pet": "Biscuit",
          "direction": "pickup",
          "queued": "17:42"
        }
      ]
    }
  • plan_transport_route Read the optimized route for the day's pet transport services. writeAsks first

    Route Optimizer is a paid add-on enabled by RunLoyal; it maps the route from the kennel to each pet owner's address. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → plan_transport_route

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/transport-route/plan

    Parameters

    Parameters: plan_transport_route
    NameTypeDescription
    date string string ISO date. Defaults to today.

    Example response

    {
      "date": "2026-11-18",
      "stops": 5,
      "order": [
        "Kennel",
        "Example Owner",
        "Sample Owner",
        "Kennel"
      ]
    }

Bookings and stays7

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

  • view_estimate Get the expected price of an appointment before booking it. read

    Uses the same pricing rules as the final invoice: multi-night discounts, holiday and weekend surcharges, breed-based pricing and taxes. If details change, the invoice can differ.

    MCP callrunloyal_read → view_estimate

    REST endpointGET https://cotlet.dev/api/v1/runloyal/estimates/view

    Parameters

    Parameters: view_estimate
    NameTypeDescription
    owner string required string Pet owner name, email or phone.
    pets array required array Pets.
    service string required string Service.
    start string required string ISO date.
    end string string ISO date.

    Example input

    {
      "owner": "owner",
      "pets": "pets",
      "service": "service",
      "start": "start"
    }

    Example response

    {
      "service": "Overnight Boarding Standard Suite",
      "nights": 4,
      "estimate": 286,
      "tax": 22.88,
      "total": 308.88
    }
  • manage_appointments List appointments, or create or edit one for one or more pets of a family. writeAsks first

    Bookings reach the pet owner and use capacity, so the agent shows service, dates and pets first. Run view_estimate to show the price. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_appointments

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/appointments/manage

    Parameters

    Parameters: manage_appointments
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `update`, `cancel`. `list` and `get` only read.
    owner string string Pet owner.
    pets array array Pets of that owner.
    service string string Boarding, daycare, grooming or another configured service.
    start string string ISO date and time.
    end string string ISO date and time.
    add_ons array array Add-ons such as an exit bath.
    repeat object object Recurrence for repeating appointments.

    Example input

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

    Example response

    {
      "appointment": "APT-48211",
      "owner": "Example Owner",
      "pets": [
        "Biscuit"
      ],
      "service": "Overnight Boarding Standard Suite",
      "start": "2026-11-21",
      "end": "2026-11-25",
      "status": "Confirmed"
    }
  • check_in_out Check in a confirmed appointment, with belongings and notes, or check it out. writeAsks first

    Only a Confirmed appointment can be checked in. Check-out leads to the invoice. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → check_in_out

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/out/check

    Parameters

    Parameters: check_in_out
    NameTypeDescription
    appointment string required string Appointment, as manage_appointments `list` returns it.
    direction string required string One of `in`, `out`.
    belongings string string What the pet arrived with.
    notes string string Appointment notes.

    Example input

    {
      "appointment": "appointment",
      "direction": "direction"
    }

    Example response

    {
      "appointment": "APT-48211",
      "pet": "Biscuit",
      "status": "Checked In",
      "belongings": "Blue leash, own food"
    }
  • move_room Move a checked-in lodging appointment to another room, for some or all days. writeAsks first

    A different room can change the price, so the agent asks whether to update the invoice. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → move_room

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/room/move

    Parameters

    Parameters: move_room
    NameTypeDescription
    appointment string required string Appointment, as manage_appointments `list` returns it.
    room string required string Target room.
    days string string One of `today`, `all_future`.
    update_invoice boolean boolean Update the invoice to the new room's price.

    Example input

    {
      "appointment": "appointment",
      "room": "room"
    }

    Example response

    {
      "appointment": "APT-48211",
      "room": "Suite 5",
      "invoice_updated": false
    }
  • record_feeding_medication Read or set a pet's feeding and medication schedule for its stay. writeAsks first

    Staff follow this during the stay, so changes wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → record_feeding_medication

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/feeding-medications

    Parameters

    Parameters: record_feeding_medication
    NameTypeDescription
    action string required string One of `list`, `update`. `list` and `get` only read.
    pet string required string Pet name with owner, as manage_pets `list` returns it.
    feeding array array Type (AM, midday, PM), amount and unit (cup, scoop, bag, can).
    medication array array Name, dose and times.

    Example input

    {
      "action": "action",
      "pet": "pet"
    }

    Example response

    {
      "pet": "Biscuit",
      "feeding": [
        {
          "type": "AM",
          "amount": 1,
          "unit": "cup"
        },
        {
          "type": "PM",
          "amount": 1,
          "unit": "cup"
        }
      ]
    }
  • add_staff_note Add or pin an internal staff note on an appointment. writeAsks first

    Staff notes are internal and not visible to the pet owner. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → add_staff_note

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/staff-notes

    Parameters

    Parameters: add_staff_note
    NameTypeDescription
    appointment string required string Appointment, as manage_appointments `list` returns it.
    text string required string The note.
    pin boolean boolean Pin it.

    Example input

    {
      "appointment": "appointment",
      "text": "text"
    }

    Example response

    {
      "appointment": "APT-48211",
      "note": "Eats slowly, give 20 minutes.",
      "pinned": true
    }
  • record_incident Add an incident to a pet's profile with its incident type and details. writeAsks first

    An incident is a lasting record on the pet, so the agent writes only what you tell it. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → record_incident

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/incidents

    Parameters

    Parameters: record_incident
    NameTypeDescription
    pet string required string Pet name with owner, as manage_pets `list` returns it.
    type string required string Incident type from Settings > Operations > Pet Incidents.
    details object required object Answers to the type's headings.

    Example input

    {
      "pet": "pet",
      "type": "type",
      "details": "details"
    }

    Example response

    {
      "pet": "Biscuit",
      "type": "Minor scuffle",
      "saved": true
    }

Pets and pet owners6

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

  • manage_pets List, add, edit or remove pets on a pet owner's profile. writeAsks first

    Removing a pet is named before it happens. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_pets

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/pets/manage

    Parameters

    Parameters: manage_pets
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `update`, `remove`. `list` and `get` only read.
    owner string string Pet owner.
    pet string string Pet, for `get`, `update`, `remove`.
    fields object object Name, breed, size and other pet details.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "owner": "Example Owner",
      "pet": "Biscuit",
      "breed": "Beagle",
      "saved": true
    }
  • manage_pet_owners List, add, edit or block pet owners. writeAsks first

    Run `list` first so the same family is not added twice. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_pet_owners

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/pet-owners/manage

    Parameters

    Parameters: manage_pet_owners
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `update`, `block`. `list` and `get` only read.
    owner string string Pet owner, for `get`, `update`, `block`.
    fields object object First and last name, email or phone, other details.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "owner": "Example Owner",
      "email": "owner@example.com",
      "saved": true
    }
  • verify_vaccinations Review vaccination records scanned by Scout AI Vax Verify and confirm or fix them. writeAsks first

    Vax Verify is a paid add-on. Where a vaccine name did not match, staff must review it; the agent shows those first. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → verify_vaccinations

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/vaccinations/verify

    Parameters

    Parameters: verify_vaccinations
    NameTypeDescription
    action string required string One of `list`, `confirm`, `update`. `list` and `get` only read.
    pet string string Pet.
    vaccines array array Vaccine and expiry date, for `update`.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "pending": [
        {
          "pet": "Biscuit",
          "vaccine": "Rabies",
          "expires": "2027-03-02",
          "needs_review": false
        }
      ]
    }
  • send_agreement_request Request that a pet owner sign one or more agreements. writeAsks first

    The owner gets it in the app or by email to sign. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → send_agreement_request

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/agreement-requests

    Parameters

    Parameters: send_agreement_request
    NameTypeDescription
    owner string required string Pet owner name, email or phone.
    agreements array required array Agreements to request.

    Example input

    {
      "owner": "owner",
      "agreements": "agreements"
    }

    Example response

    {
      "owner": "Example Owner",
      "agreements": [
        "Boarding Agreement"
      ],
      "requested": true
    }
  • manage_pet_tags Create pet or owner tags, assign them and turn on tag-based alerts. writeAsks first

    Tags and alerts are internal, never shown to pet owners. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_pet_tags

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/pet-tags/manage

    Parameters

    Parameters: manage_pet_tags
    NameTypeDescription
    action string required string One of `list`, `create`, `assign`, `activate_alert`. `list` and `get` only read.
    tag string string Tag name.
    pet string string For `assign`.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "tag": "Escape artist",
      "pet": "Biscuit",
      "alert": true
    }
  • manage_curriculum Create a training curriculum with practices and homework. writeAsks first

    Pet owners see the homework in the app. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_curriculum

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/curriculum/manage

    Parameters

    Parameters: manage_curriculum
    NameTypeDescription
    action string required string One of `list`, `create`, `add_homework`. `list` and `get` only read.
    lesson string string Lesson name, for example Introduction & Socialization.
    homework object object Name and whether owners upload photos or videos.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "lesson": "Loose leash walking",
      "homework": "Two 5 minute walks a day",
      "media_upload": true,
      "saved": true
    }

Messages and marketing6

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

  • send_report_card Create and send a report card for one pet or in bulk. writeAsks first

    Report cards reach pet owners, so the agent shows each one before sending. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → send_report_card

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/report-cards

    Parameters

    Parameters: send_report_card
    NameTypeDescription
    pets array required array Pets with appointments today.
    notes string required string Activities, energy level, favorite playmates and so on.
    photos array array Photo links.

    Example input

    {
      "pets": "pets",
      "notes": "notes"
    }

    Example response

    {
      "sent": 1,
      "pet": "Biscuit",
      "owner": "Example Owner"
    }
  • send_message Send a pet owner a message from Message Hub, by app or SMS. writeAsks first

    By default messages go through the app, or email if the owner has no app notifications. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → send_message

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/messages

    Parameters

    Parameters: send_message
    NameTypeDescription
    owner string required string Pet owner name, email or phone.
    text string required string The message.
    channel string string One of `app`, `sms`. SMS needs the SMS add-on.

    Example input

    {
      "owner": "owner",
      "text": "text"
    }

    Example response

    {
      "owner": "Example Owner",
      "channel": "app",
      "sent": true
    }
  • send_campaign Send an email, app or SMS campaign to a segment of pet owners. writeAsks first

    A campaign reaches many customers at once, so the agent shows segment, count and text first. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → send_campaign

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/campaigns

    Parameters

    Parameters: send_campaign
    NameTypeDescription
    segment string required string All pet owners, visited in the last 3 months, a service type, birthdays this month and so on.
    channels array required array `email`, `app`, `sms`.
    subject string string Subject.
    text string required string Message.

    Example input

    {
      "segment": "segment",
      "channels": "channels",
      "text": "text"
    }

    Example response

    {
      "segment": "Birthdays this month",
      "recipients": 58,
      "channels": [
        "email",
        "app"
      ],
      "sent": true
    }
  • manage_reviews Read internal reviews or turn on Request review for an appointment. writeAsks first

    The request reaches the pet owner after checkout. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_reviews

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/reviews/manage

    Parameters

    Parameters: manage_reviews
    NameTypeDescription
    action string required string One of `list`, `request`. `list` and `get` only read.
    appointment string string For `request`.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "reviews": [
        {
          "owner": "Example Owner",
          "rating": 5,
          "text": "Biscuit came home happy."
        }
      ]
    }
  • manage_rewards Read or set how pet owners earn and redeem loyalty points. writeAsks first

    Points come from invoice payments and lower future bills, so changes wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_rewards

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/rewards/manage

    Parameters

    Parameters: manage_rewards
    NameTypeDescription
    action string required string One of `get`, `update`. `list` and `get` only read.
    earning object object By spend ranges or by item type.
    redemption object object Points per discount.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "earning": {
        "per_dollar": 1
      },
      "redemption": {
        "points": 500,
        "discount": 10
      }
    }

Money: invoices, memberships and retail8

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

  • view_open_invoices List open invoices and read one by number. read

    Open Invoice lists every unpaid invoice. Changes go through the payment, coupon and refund tools.

    MCP callrunloyal_read → view_open_invoices

    REST endpointGET https://cotlet.dev/api/v1/runloyal/open-invoices/view

    Parameters

    Parameters: view_open_invoices
    NameTypeDescription
    invoice string string Invoice number. Leave empty to list all open invoices.

    Example response

    {
      "open_invoices": [
        {
          "invoice": "INV-9-8552",
          "owner": "Example Owner",
          "total": 312.5
        }
      ]
    }
  • refund_invoice Refund items with their payment, or only the payment, on an invoice. writeAsks first

    A refund returns money to the customer and cannot be undone by the agent. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → refund_invoice

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/invoice/refund

    Parameters

    Parameters: refund_invoice
    NameTypeDescription
    invoice string required string Invoice number.
    type string required string One of `items_and_payment`, `payment_only`.
    items array array Items to refund.
    clear_balance boolean boolean For `payment_only`: clear the balance or leave it due.

    Example input

    {
      "invoice": "invoice",
      "type": "type"
    }

    Example response

    {
      "invoice": "INV-9-8552",
      "refunded": 45,
      "balance_due": 0
    }
  • manage_tips Read or set tip choices: percent or dollar, quick picks and calculation. writeAsks first

    Needs permission to manage Pricing. Tip choices show on terminals and checkout. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_tips

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/tips/manage

    Parameters

    Parameters: manage_tips
    NameTypeDescription
    action string required string One of `get`, `update`. `list` and `get` only read.
    settings object object Tip type, quick-pick percentages and how tips are calculated.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "type": "percent",
      "quick_picks": [
        15,
        18,
        20
      ]
    }
  • manage_coupons Create a coupon or apply one to an invoice. writeAsks first

    Coupons can cover services, packages, memberships and products, once or recurring. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_coupons

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/coupons/manage

    Parameters

    Parameters: manage_coupons
    NameTypeDescription
    action string required string One of `list`, `create`, `apply`. `list` and `get` only read.
    name string string Coupon name.
    code string string Code.
    discount string string Percent or amount.
    expires string string ISO date.
    invoice string string For `apply`.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "coupon": "Weekday daycare",
      "code": "WEEKDAY10",
      "discount": "10%",
      "saved": true
    }
  • manage_packages List or create packages with credits for daycare, boarding or add-ons. writeAsks first

    Settings > Retail > Packages. Customers buy them, so price changes wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_packages

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/packages/manage

    Parameters

    Parameters: manage_packages
    NameTypeDescription
    action string required string One of `list`, `create`. `list` and `get` only read.
    name string string Package name.
    credits array array Service and number of credits.
    price number number Price.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "package": "10 Day Daycare Pack",
      "credits": [
        {
          "service": "Daycare",
          "credits": 10
        }
      ],
      "price": 320,
      "saved": true
    }
  • manage_memberships Enroll a pet owner in a membership, or pause or cancel one. writeAsks first

    Memberships are a paid add-on and charge the owner, so each change waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_memberships

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/memberships/manage

    Parameters

    Parameters: manage_memberships
    NameTypeDescription
    action string required string One of `list`, `enroll`, `pause`, `cancel`. `list` and `get` only read.
    owner string required string Pet owner name, email or phone.
    membership string string Membership.

    Example input

    {
      "action": "action",
      "owner": "owner"
    }

    Example response

    {
      "owner": "Example Owner",
      "membership": "Monthly Park Pass",
      "status": "Active",
      "auto_renew": true
    }
  • manage_gift_cards Sell an e-gift card to a pet owner's account or apply one to an invoice. writeAsks first

    This moves money on the owner's account, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_gift_cards

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/gift-cards/manage

    Parameters

    Parameters: manage_gift_cards
    NameTypeDescription
    action string required string One of `sell`, `apply`. `list` and `get` only read.
    owner string required string Pet owner name, email or phone.
    amount number number Amount, for `sell`.
    invoice string string For `apply`.

    Example input

    {
      "action": "action",
      "owner": "owner"
    }

    Example response

    {
      "owner": "Example Owner",
      "gift_card": 50,
      "balance": 50
    }
  • manage_retail_products Add a retail product with its UPC, or add one to a Quick Checkout invoice. writeAsks first

    Products added at Organization level are available at every location; a SKU is generated. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_retail_products

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/retail-products/manage

    Parameters

    Parameters: manage_retail_products
    NameTypeDescription
    action string required string One of `list`, `create`, `sell`. `list` and `get` only read.
    name string string Product name.
    upc string string UPC.
    owner string string For `sell`: the customer.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "product": "Salmon training treats",
      "upc": "000000000001",
      "sku": "SKU-1042",
      "saved": true
    }

Reports and setup8

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

  • run_paw_metrics_report Run any Paw Metrics report your staff group may see, for a date range. read

    Which reports exist for the signed-in user follows its staff group settings.

    MCP callrunloyal_read → run_paw_metrics_report

    REST endpointGET https://cotlet.dev/api/v1/runloyal/paw-metrics-reports/run

    Parameters

    Parameters: run_paw_metrics_report
    NameTypeDescription
    report string required string Report name, as Paw Metrics lists it.
    from string required string ISO start date.
    to string required string ISO end date.

    Example input

    {
      "report": "report",
      "from": "from",
      "to": "to"
    }

    Example response

    {
      "report": "Revenue by Service",
      "rows": [
        {
          "service": "Boarding",
          "revenue": 18420
        },
        {
          "service": "Daycare",
          "revenue": 12960
        }
      ]
    }
  • view_membership_report Read the Membership Details report, for example members not on auto renew. read

    Returns each member with membership type and auto renewal.

    MCP callrunloyal_read → view_membership_report

    REST endpointGET https://cotlet.dev/api/v1/runloyal/membership-reports/view

    Parameters

    Parameters: view_membership_report
    NameTypeDescription
    membership_type string string Monthly or annual membership type.
    auto_renew boolean boolean Filter by auto renewal.

    Example response

    {
      "members": [
        {
          "owner": "Example Owner",
          "membership": "Monthly Park Pass",
          "auto_renew": false
        }
      ]
    }
  • export_pet_owner_details Run the Pet Owner Details report in Paw Metrics and download it. read

    A contact export for the date range. Handle it as your customers' personal data.

    MCP callrunloyal_read → export_pet_owner_details

    REST endpointGET https://cotlet.dev/api/v1/runloyal/pet-owner-details/export

    Parameters

    Parameters: export_pet_owner_details
    NameTypeDescription
    from string required string ISO start date.
    to string required string ISO end date.
    format string string One of `csv`, `excel`, `pdf`.

    Example input

    {
      "from": "from",
      "to": "to"
    }

    Example response

    {
      "report": "Pet Owner Details",
      "rows": 612,
      "file": "pet-owner-details.csv"
    }
  • edit_timesheets Read staff clock in and out, breaks and hours, or correct an entry. writeAsks first

    Corrections change paid hours, so they wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → edit_timesheets

    REST endpointPATCH https://cotlet.dev/api/v1/runloyal/timesheets

    Parameters

    Parameters: edit_timesheets
    NameTypeDescription
    action string required string One of `list`, `update`. `list` and `get` only read.
    staff string string Staff member.
    facility string string Facility.
    entry object object For `update`: date, clock in and clock out.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "staff": "Kennel tech A",
      "date": "2026-11-17",
      "clock_in": "06:58",
      "clock_out": "15:04",
      "hours": 7.6
    }
  • manage_services List service categories and services, or create a lodging-based service. writeAsks first

    Lodging availability comes from the number of runs, or spots for cage-free boarding. Services show in booking for your customers. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_services

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/services/manage

    Parameters

    Parameters: manage_services
    NameTypeDescription
    action string required string One of `list`, `create`, `update`. `list` and `get` only read.
    category string string Service category, for example Overnight Boarding.
    service object object Name, runs or spots, price and optional add-ons.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "category": "Overnight Boarding",
      "service": "Overnight Boarding Luxury Suite",
      "saved": true
    }
  • manage_dynamic_pricing List or add Dynamic Pricing rules by booking days and capacity. writeAsks first

    Dynamic Pricing is an add-on. Rules change what customers pay, so they wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_dynamic_pricing

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/dynamic-pricing/manage

    Parameters

    Parameters: manage_dynamic_pricing
    NameTypeDescription
    action string required string One of `list`, `create`, `update`. `list` and `get` only read.
    rule string string Rule name, for example Boarding Discount for Weekdays.
    services array array Services it applies to.
    booking_days object object Booking day range.
    capacity object object Capacity threshold and price change.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "rule": "Daycare Price Increase for Full Capacity",
      "capacity_over": "85%",
      "change": "+10%",
      "saved": true
    }
  • manage_staff_groups List staff groups or create one with its sections, actions and reports. writeAsks first

    Admin and Staff are default groups and cannot be edited. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_staff_groups

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/staff-groups/manage

    Parameters

    Parameters: manage_staff_groups
    NameTypeDescription
    action string required string One of `list`, `create`, `update`. `list` and `get` only read.
    group string string Group name, for example Manager.
    permissions array array Sections, actions and reports allowed.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "group": "Manager",
      "permissions": 24,
      "saved": true
    }
  • manage_business_hours Read or set Global Business Hours and closed days. writeAsks first

    Hours set the earliest drop-off and latest pickup in both portals. By default you confirm each call; you can switch that off for this tool.

    MCP callrunloyal_write → manage_business_hours

    REST endpointPOST https://cotlet.dev/api/v1/runloyal/business-hours/manage

    Parameters

    Parameters: manage_business_hours
    NameTypeDescription
    action string required string One of `get`, `update`. `list` and `get` only read.
    hours array array Days or date ranges with open and close times.
    closed array array Closed dates or weekdays.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "hours": [
        {
          "days": "Mon-Fri",
          "open": "07:00",
          "close": "19:00"
        }
      ],
      "closed": [
        "2026-12-25"
      ]
    }
Encrypted, revocable

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

30 tools ask first

Approvals, undo and mistakes Pet owners get nothing and pay nothing until you say so.

  1. 01 Get the estimate view_estimate uses your pricing rules.
  2. 02 Check the calendar Free rooms for the dates.
  3. 03 Show you the booking Pet, service, dates and add-ons.
  4. 04 Book after your OK manage_appointments creates the stay.
Fixing a RunLoyal write that went wrong
ActionHow to put it right
Appointment dates or roomCall manage_appointments or move_room again with the right values
Pet details, tags, feedingUpdate them again with the same tool
Report card, message or campaignAlready delivered: follow up with the owners
RefundMoney 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.

Pay per call

How much does the RunLoyal MCP server cost?

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

Illustrative month, our assumption: successful calls for this workload
JobCallsCredits
Evening pet count and free rooms2 × 30600
Daycare report cards, sent in bulk2 × 22440
Stays quoted and booked2 × 40800
Vaccination review and owner messages6 × 4240
Membership and birthday campaigns4 × 140
Cloud Browser, 30 days1,500
Total212 calls3,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.

Cotlet credit packs: price, credits and calls at 10 credits each
Credits Price, one time Calls at 10 credits Per 1,000 credits
5,000 $29 500 $5.80
15,000 $79 1,500 $5.27
32,000 $149 3,200 $4.66
60,000 $249 6,000 $4.15

Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header.

Other options

RunLoyal MCP server: other ways to connect What each route does for a pet care business, and where it stops.

Other ways to work with RunLoyal, checked 17 Nov 2026
OptionWhat it doesWhere it stops
RunLoyal Partner APIsPet owner sign-in, pets, bookings, invoices, gift cards and rewards.No front desk, report card, messaging or reporting endpoints; credentials through RunLoyal.
Zapier integrationConnects RunLoyal to other tools, set up per RunLoyal's knowledge base.Whatever triggers and actions the Zapier app offers.
Mailchimp integrationMore advanced campaign work in Mailchimp.Marketing only.
Scout AIRunLoyal'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.

EU company, since 2019

Who runs Cotlet A company you can look up.

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.

Let your agent send today's RunLoyal report cards.

Free 7-day trial with 2,000 credits, no card needed.