juggle-mcp

MCP server for Juggle — the babysitting and petsitting marketplace — for a family account: your sits and the sitters who applied, sitter profiles and reviews, and your messages, plus confirmation-gated booking changes.

Developed and maintained by AI (Claude Code). Not affiliated with Juggle. The site has no public API; this server signs in with your email and password and uses the same routes the website does. Those routes were mapped from the site's JavaScript. Every read tool and the favorite / unfavorite writes have been verified against a signed-in family account (2026-11-03); the other writes (post a sit, accept / decline a sitter, cancel, message, review) reach other people and are not yet verified live — see docs/JUGGLE-API.md.

Setup

npx -y @chrischall/juggle-mcp

Variable	Required	Description
`JUGGLE_EMAIL`	yes	The email you sign in to whyjuggle.com with (a family account).
`JUGGLE_PASSWORD`	yes	Your whyjuggle.com password. Google/Facebook-only sign-ins are not supported — set a password on the site first.
`JUGGLE_BASE_URL`	no	Site origin override, for tests / a local stub only. Default `https://whyjuggle.com`; must be https (loopback http allowed).
`MCP_CONFIRM_MODE`	no	Confirm-gated writes on clients without prompts (claude.ai, Claude Desktop): `ask-user` (default) — the first call sends nothing and returns a preview + `confirmToken`, and the model must get your approval before repeating it with the token; `auto` — the model may use the token after reviewing the preview; `refuse` — writes are refused.
`MCP_CONFIRM_ELICITATION`	no	`off` skips the confirmation prompt even on clients that declare elicitation support.
`MCP_CONFIRM_TTL_SECONDS`	no	How long a `confirmToken` stays valid (default 600).

The server starts without credentials (so hosts can list its tools); the first tool call reports what is missing. A rejected password is never retried automatically.

Tools

Reads

Tool	What it does
`juggle_healthcheck`	Check the Juggle sign-in is configured and accepted, and that an authenticated page read works
`juggle_get_profile`	Your family profile: account, city, membership, job stats, saved addresses (ids for posting a sit), pets; kids only on request
`juggle_get_payments_summary`	Your city rates, saved cards (brand/last 4), membership, promo credits and recent transactions, in dollars
`juggle_list_bookings`	List your sits/jobs: status, service, start time, booked sitter, pending applications; active, past or by status
`juggle_get_booking`	One booking in detail: times, kids/pets, notes, applicants and booked sitters, payment total, what you can do
`juggle_list_sitters`	Search sitters in your city by availability window, services, keywords or name
`juggle_list_favorites`	List the sitters you have marked as favorites. Reports `returned` (the favorites count) and, if Juggle's 200-sitter cap may have cut the list short, a `note`; since 0.1.1 it no longer reports `totalNumSitters`, which was the city-wide sitter count, not your favorites
`juggle_get_sitter`	A sitter public profile: rating, experience, school, certifications, bio — never private details
`juggle_get_reviews`	Reviews other families left for a sitter, with total count and average rating
`juggle_list_conversations`	Your message conversations with sitters: last message, time, unread count
`juggle_get_conversation`	Read the messages in one conversation, newest page first
`juggle_list_locations`	Cities Juggle serves and their published babysitting/petsitting rates (no sign-in needed)

Reads take view: compact (default) is a small projection, while full and raw return more upstream fields. juggle_list_bookings and juggle_list_conversations also take brief (one line per item, for mcp-host's context groups; see the skill's "In context groups"). On the profile, sitter and payments tools, even raw stays inside the privacy allowlists. The private fields on a sitter's profile row (phone, birthdate, emergency contacts, background-check answers, social handles), the family's phone numbers and house instructions, and the Stripe secrets on the payments page are never returned. The one exception is a booking, which shows the phone number of the sitter booked for that sit, the same as the site does. Kids' details come back only with include_kids. Tools that return other people's text (messages, reviews, sitter bios, booking notes) frame it as untrusted.

Writes (confirm-gated)

Tool	What it does
`juggle_post_job`	Post a one-time babysitting/petsitting/homeschool-help job (sit), optionally inviting a sitter
`juggle_accept_sitter`	Accept (book) a sitter who applied to one of your jobs
`juggle_decline_sitter`	Decline a sitter's application to one of your jobs
`juggle_cancel_booking`	Cancel a booking; late cancels only via the one-star-review penalty, never the fee
`juggle_send_message`	Send a text message in one of your sitter conversations
`juggle_favorite_sitter`	Add a sitter to your favorites
`juggle_unfavorite_sitter`	Remove a sitter from your favorites
`juggle_leave_review`	Leave a 0-5 star (half-star) review of a sitter for a finished booking

Each write's first call sends nothing. It does a fresh read and returns a preview plus a confirmToken. Repeating the call with that token sends the request exactly once (see MCP_CONFIRM_MODE above). A 5xx or a dropped connection after the send is reported as status: "unknown" and is never retried. Nothing that moves money (tips, payments, cancellation fees, subscriptions, gift cards) is in scope, and a late cancel never pays the fee.

Skill (no server needed)

skills/juggle is a curl + jq helper (skills/juggle/scripts/juggle) for the same reads from a shell. It runs under bash or zsh, keeps its own 0600 session file at ~/.config/juggle/session, and applies the same privacy allowlists. It is read-only; writes stay in the MCP. Claude Code discovers it automatically when this repo is installed as a plugin.

Hosting

Hostable on mcp-host (claude.ai remote MCP) as a per-user connector, with no browser bridge, because sign-in is a plain server-side email and password POST. mint.yaml declares identity.perUserChild and asks each person for their own JUGGLE_EMAIL / JUGGLE_PASSWORD on the authorize page, so no shared secret is involved. Egress is whyjuggle.com only. The skill is local-only: it runs wherever curl and jq are installed.

Development

npm install
npm run build
npm test        # both typechecks + vitest (no network)

License

MIT

Juggle

What it does

What it costs