# Paw Planner AI for AI agents

AI agents are welcome. There are two ways in, depending on whether you are acting for someone with a Paw Planner account.

## 1. Read the site

- https://pawplannerai.com/llms.txt — summary; https://pawplannerai.com/llms-full.txt — everything
- Any page listed there as Markdown: add .md to the path (/index.md, /claude.md, /ai.md) or send `Accept: text/markdown`

## 2. Act for a Paw Planner user (MCP)

Paw Planner is an MCP server. A user on the AI plan connects Claude (or Claude Code, Cursor, any MCP client with OAuth) to their own account and the agent acts as them.

- MCP endpoint: https://pawplannerai.com/api/v1/mcp (Streamable HTTP, JSON responses, tools only)
- Auth: OAuth 2.1 with PKCE and dynamic client registration. Discovery: https://pawplannerai.com/.well-known/oauth-protected-resource/api/v1/mcp and https://pawplannerai.com/.well-known/oauth-authorization-server
- An unauthenticated request to the endpoint returns 401 with a WWW-Authenticate challenge naming the resource metadata; follow it.
- Scope: the connected user's own clients and bookings only. delete_booking requires the user's confirmation. Dates are YYYY-MM-DD, times HH:MM, money USD, miles are round trips.
- Guide for people: https://pawplannerai.com/claude

Tools:
- list_clients: your clients with pets and contact details; call first for ids
- get_client: one client in full with lifetime totals and recent bookings
- create_client: add a client; the street address is what mileage measures to
- add_pet: add a pet to a client with breed, age, weight and care notes
- list_bookings: upcoming or past bookings with pay, status and round-trip miles
- get_booking: one booking in full with the client and pets
- create_booking: book a visit; mileage, drive time and Google Calendar sync happen automatically
- update_booking: edit date, times, service, price, status or notes; only passed fields change
- mark_paid: record that a booking was paid
- cancel_booking: cancel a booking and keep it in history
- delete_booking: delete a booking permanently, only after you confirm
- business_summary: the dashboard: revenue, miles, deduction, unpaid, next seven days
- mileage_report: deductible round-trip miles for a year or range, every trip listed
- revenue_report: revenue by service type and client, paid and unpaid, for a period
- list_unpaid: completed bookings nobody has paid for yet, with the total owed
- list_service_rates: your saved default rates and the service types you use
- grade_booking: the AI gig grade (A to F) with its rationale

The user connects you from their side: they add the MCP URL in their client and approve it once on pawplannerai.com. AI plan only.

## No anonymous API

There is no anonymous API: every record belongs to a pet sitter and is private to them. An agent that needs a sitter's data connects over MCP with that sitter's approval (above).
The REST API under https://pawplannerai.com/api/v1/ is the web app's own and is not a supported agent surface; the MCP tools are.

---

HTML version: https://pawplannerai.com/ai. All pages: https://pawplannerai.com/llms.txt.