# Paw Planner AI

> Business management for pet sitters: bookings, automatic mileage, revenue and tax reports. Pet sitters track bookings, clients and pets, log round-trip mileage automatically at the IRS rate, and see revenue and tax deductions. AI-plan users can connect Claude to their account over MCP.

- Product: Paw Planner AI — Business management for pet sitters: bookings, automatic mileage, revenue and tax reports.
- Built by: Pulse AI Solutions (https://pulseaisolutions.com)
- Who it is for: independent pet sitters and dog walkers running a small business from their phone
- Free to start; the AI plan (gig grader, AI drafts, Claude connector) is enabled per account
- Mileage: round trips from the sitter's home to each client, measured automatically with Google Maps and logged at the IRS rate of $0.70 a mile
- Web app at https://pawplannerai.com; mobile-first, no install
- Support: support@pawplannerai.com

## Pages (Markdown)

Every page below has a Markdown twin: add .md to the path, or request the HTML URL with Accept: text/markdown. Everything is in https://pawplannerai.com/llms-full.txt.

- [Home](https://pawplannerai.com/index.md): What Paw Planner is, in one page
- [Claude connector](https://pawplannerai.com/claude.md): Connect Claude or any MCP client to a Paw Planner account
- [For AI agents](https://pawplannerai.com/ai.md): How to read the site and act for a user

## For AI agents acting 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

## For AI agents without an account

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.