Developers & agents

Streamable HTTP MCP for waitlist & ratio forecasting

JSON-RPC at https://ratioseat.com/api/mcp — initialize, tools/list, tools/call, and ping. Same business logic as the director app, with confirm-gated writes.

Agents: start at /llms.txt or the markdown twin.

Get RatioSeat Pro — $29/mo Start free (director app)

Pricing

Free / demo

Read-only MCP tools with tight rate limits. Read-only demo: Bearer rs_test_demo (Sunshine Kids Austin seed). Mutating tools return upgrade_required.

RatioSeat Pro — $29/mo

Director app + self-serve MCP keys in Settings → MCP. Write and notify tools allowed with confirm / dry_run defaults.

Connect

Endpoint

https://ratioseat.com/api/mcp

Steps

Subscribe to RatioSeat Pro (Stripe checkout) or use the read-only demo key.
Mint a key at Settings → MCP.
Add to your MCP host with Authorization: Bearer <key>.
Send JSON-RPC initialize then tools/list.

Protected resource metadata: /.well-known/oauth-protected-resource

Starter tool catalog

Tool	What it does	Effects	Confirm?
forecast_openings	Project seat openings by classroom over the next few weeks from DOB move-ups, withdrawals, and kindergarten exits.	Read	No
simulate_enrollment	Run a what-if enrollment: see cascade impact and ratio risk before you commit a seat or schedule pack.	Read / write if persisted	When saving a scenario
list_ratio_risks	List projected ratio, group-size, and staffing risks for a date or range under your active ratio profile.	Read	No
send_offer_email	Preview or send an enrollment offer email to a waitlisted family (dry-run by default on agent keys).	Write + notify	Before a live send
update_waitlist_priority	Change a waitlist entry’s priority tier with a mandatory audit reason.	Write	Yes

Full catalog (21 customer tools) is live on the MCP endpoint — weekly digest, offers, and transitions included. Part-time packing, roster import, and custom ratio overrides are not advertised until implemented.

Safety

Confirm-gated writes, per-org rate limits, structured JSON-RPC errors, and idempotency keys on mutating tools/call. HTTP 401 includes WWW-Authenticate with resource metadata URL.

Planning aid — not legal advice

RatioSeat MCP responses include ratio-pack metadata and a planning-aid disclaimer. They do not certify licensing compliance.

Compliance & disclaimers