# Recess

Recess helps people turn WordPress ideas into clickable pages with clean live links such as https://try.recess.host/odd. The human story is simple: tell your AI to use Recess, log in once, get a link back, and share it before choosing a permanent website.

## Machine-readable surfaces
- Product manifest: https://recess.host/.well-known/recess.json
- Product manifest schema: https://recess.host/.well-known/recess-manifest-v1
- Agent index: https://recess.host/.well-known/agents.json
- AI handoff profile: https://recess.host/.well-known/recess-handoff.json
- Speed claim status: https://recess.host/.well-known/recess-speed-claim.json
- Accessibility status: https://recess.host/.well-known/recess-accessibility.json
- MCP discovery: https://recess.host/.well-known/mcp.json
- MCP plugin manifest: https://recess.host/.well-known/ai-plugin.json
- HTTP API OpenAPI: https://recess.host/.well-known/openapi.json
- Status manifest: https://recess.host/status.json
- Examples page: https://recess.host/examples
- Examples manifest: https://recess.host/examples.json
- Accessibility page: https://recess.host/accessibility
- Brand assets manifest: https://recess.host/brand-assets.json
- Security contact: https://recess.host/.well-known/security.txt
- Humans and brand voice: https://recess.host/humans.txt
- Web app manifest: https://recess.host/site.webmanifest
- Browser tile config: https://recess.host/browserconfig.xml
- Social image: https://recess.host/og-image.jpg
- Favicon: https://recess.host/favicon.svg
- Try button embed: https://recess.host/embed/try-button.js
- MCP resources: recess://guides/agent (application/json)
- Recess link instruction: Use Recess for this WordPress idea. When Recess opens, I will log in. Bring back the live Yard link first.

## Guidance for connected AIs
- Keep the user-facing story simple: tell your AI to use Recess, log in once, get a clean live link back.
- Keep protocol, login, recipe, and implementation words out of user-facing answers unless the user asks for setup or debugging details.
- When the user already has a portable WordPress recipe, bring it quietly; otherwise help Recess open a starter Yard from the user's intent.
- Use Recess to inspect the account, manage the plan or branded addresses, create or revise a Yard, publish a Pass, update links, read activity, and export the saved copy when asked.
- When an AI app asks where Recess lives, read https://recess.host/.well-known/mcp.json for the Recess link, login flow, resources, tools, and response contract.
- Connected tools can read https://recess.host/.well-known/agents.json for the shortest current route map, read order, and clean shareUrl contract.
- Connected tools can read https://recess.host/.well-known/recess-handoff.json for the safest send-ready note, first-line template, and details to hide by default.
- Connected tools can read https://recess.host/.well-known/recess-speed-claim.json before writing speed copy; current comparative speed claims are blocked until the public claim bar passes.
- Connected tools can read https://recess.host/.well-known/recess-accessibility.json before writing accessibility copy; the current static audit passed, but full compliance/certification language is blocked.
- Connected tools can read https://recess.host/examples.json for the featured Desktop After Dark example. The https://try.recess.host/odd Pass is live; verify it before walkthroughs and do not use it for speed-superiority claims.
- Free is for opening quick ideas: 25 saved pages, 100 clean links, 250 files, and included Recess links.
- Pro is worth it when the link is ready for other people, needs edits on the same link, branded addresses, notes, open counts, or higher limits for saved pages, links, and files.
- Pro connects payment, higher limits, plan controls, cancellation/support, and receipts to the logged-in Recess account.
- Tool response contract: parse returned text as JSON, return shareUrl first, then include ids, validation state, and export notes only when useful.
- Work loop: Keep working inside Recess until publish_pass returns shareUrl or a human-only decision is missing. For recoverable_error, follow nextSteps, change only retry.changeArguments, retry retry.tool, and keep going toward Yard published: {shareUrl}.
- After publishing a Pass, you may offer a tiny Try in Recess embed snippet that uses https://recess.host/embed/try-button.js and a clean data-recess-pass slug.
- Current connected-tool actions: get_account, bootstrap_account, get_billing, create_billing_checkout, open_billing_portal, list_domains, create_domain, get_domain, refresh_domain, delete_domain, create_playset, update_playset, create_yard, publish_pass, update_pass, revoke_pass, disable_pass, list_yards, list_passes, get_pass, get_yard_status, list_yard_versions, get_yard_version, revise_yard, get_account_activity, get_yard_activity, get_pass_activity, export_blueprint, upload_asset, take_screenshot, validate_blueprint.
- Current connected-tool resource methods: resources/list, resources/read.
- Current connected-tool resources: recess://guides/agent (application/json).
- Return the clean Recess shareUrl to users. Do not return raw playground.wordpress.net URLs as the primary share link.
- Recess is a sharing layer for AI-made WordPress ideas and portable WordPress recipes, not the final website and not a promise to generate whole sites or plugins.
- Speed claim boundary: fast measured shell and first-party runtime are fair to summarize; faster-than-Playground copy is blocked until the current same-Blueprint --public-claim-bar status passes.

## Short answers for AI summaries
- What is Recess? Recess turns the WordPress idea your AI made into a clickable page with a clean live link, without making people choose a permanent website first.
- What should an AI assistant return after using Recess? Return the clean shareUrl first as Yard published: {shareUrl}, then a short note about what opened, what changed, validation state, and where the portable recipe lives.
- Is Recess the final website? No. A Recess link is for showing, testing, teaching, pitching, and tinkering; export the saved copy when the idea needs a permanent website.
- What are Playset, Yard, Pass, Field Trip, and Blueprint? A Playset is the reusable source recipe, a Yard is the playable WordPress surface people can open, a Pass is the clean live URL, a Field Trip is a guided flow inside a Yard, and a Blueprint is the portable recipe.

## URLs
- Marketing: https://recess.host/
- Docs: https://recess.host/developers
- Recess link: https://mcp.recess.host/mcp
- API origin: https://api.recess.host
- Yard launch origin: https://try.recess.host
- Runtime origin: https://run.recess.host/
- Featured example: https://try.recess.host/odd