# info.summary
Create Playsets, open Yards, publish clean Pass links, and export portable recipes.

# info.description
Recess turns AI-made WordPress ideas into clean live links. The HTTP API is for direct automation with a bearer token and X-Recess-Account header. For AI clients with user login, prefer the OAuth MCP endpoint at https://mcp.recess.host/mcp. Backstage, Recess publishes AI-made WordPress ideas as playable Yards; it is not production WordPress hosting.

# tags[].description
Turn portable WordPress recipes into playable Yards.

# tags[].description
Create and manage clean share links for Yards.

# tags[].description
Validate and export portable WordPress recipes.

# tags[].description
Read launch and Yard analytics without touching the hot path.

# tags[].description
Inspect account, plan, and entitlement state.

# x-recess.contractScope
Curated public automation contract for bearer-token HTTP clients. It is not a dump of app-only proxy routes, Stripe webhook receivers, or launch telemetry ingestion.

# x-recess.responseContract.parseRule
Parse JSON responses before reading fields, then return shareUrl first.

# x-recess.speedClaimStatusSummary.agentInstruction
When summarizing Recess speed, say the latest exact same-Blueprint basic/front-page local claim-bar run passed, while fastest-in-the-world and broad faster-than-Playground claims remain blocked pending the 10-hit same-Blueprint regional/mobile proof matrix. Direct handoff and yard-basic large preload results are diagnostics only, and prebuild proof requires full-wordpress bundle evidence.

# x-recess.speedClaimStatusSummary.allowedPublicClaims[]
In the latest exact basic/front-page north-america desktop broadband same-Blueprint basic/front-page control, Recess beat public Playground on cold selected and corroborated usable WordPress signals.

# x-recess.speedClaimStatusSummary.allowedPublicClaims[]
Recess has lower measured branded-shell timing in the latest local basic/front-page control.

# x-recess.speedClaimStatusSummary.allowedPublicClaims[]
Recess serves the Yard through a verified first-party Playground runtime on run.recess.host.

# x-recess.speedClaimStatusSummary.allowedPublicClaims[]
The latest basic/front-page proof observed zero Recess hot-path upstream requests to playground.wordpress.net.

# x-recess.speedClaimStatusSummary.allowedPublicClaims[]
The latest basic/front-page proof observed zero editor-optional hot-path regressions.

# x-recess.speedClaimStatusSummary.allowedPublicClaims[]
This is exact-scope proof only; broad fastest-in-the-world language still needs the 10-hit same-Blueprint regional/mobile proof matrix.

# x-recess.speedClaimStatusSummary.blockedPublicClaims[]
faster than public Playground for every Blueprint, Yard, region, device, or network

# x-recess.speedClaimStatusSummary.blockedPublicClaims[]
cold click-to-usable superiority beyond the latest exact basic/front-page proof scope

# x-recess.speedClaimStatusSummary.blockedPublicClaims[]
ready prebuild proof for the basic/front-page no-prebuild control

# x-recess.speedClaimStatusSummary.blockedPublicClaims[]
direct handoff as broad public speed proof

# x-recess.speedClaimStatusSummary.blockedPublicClaims[]
yard-basic plus preload-mode=large as a default-worthy launch profile

# x-recess.speedClaimStatusSummary.blockedPublicClaims[]
prebuild proof from wp-content bundles that still use the stock WordPress install path

# x-recess.prebuildPolicy.values[].useWhen
Use for normal publishing; heavy Yards queue prebuilds while light proof Yards stay immediate.

# x-recess.prebuildPolicy.values[].effect
Queues prebuilds only when the Yard shape needs them.

# x-recess.prebuildPolicy.values[].agentInstruction
Report the returned prebuild.status and keep speed claims evidence-bound.

# x-recess.prebuildPolicy.values[].useWhen
Use for light proof or paid Yards when the operator wants ready-bundle evidence.

# x-recess.prebuildPolicy.values[].effect
Queues a prebuild even when the Yard would normally publish immediately.

# x-recess.prebuildPolicy.values[].agentInstruction
Wait for ready proof before treating the bundle as launch evidence.

# x-recess.prebuildPolicy.values[].useWhen
Use when immediate publishing matters more than prebuild proof.

# x-recess.prebuildPolicy.values[].effect
Prevents prebuild queueing for the Pass.

# x-recess.prebuildPolicy.values[].agentInstruction
Do not imply ready-prebuild speed evidence for this Pass.

# x-recess.prebuildPolicy.bundleModes.wp-content
Content import only; Playground still performs the normal WordPress install.

# x-recess.prebuildPolicy.bundleModes.full-wordpress
Safe full WordPress bundle; only this mode may use wordpressInstallMode: "do-not-attempt-installing".

# x-recess.prebuildPolicy.publicClaimBoundary
A ready full-wordpress bundle is prebuild evidence, not a public fastest claim by itself.

# x-recess.handoffProfileSummary.safePublicNoteTemplate
Yard published: {shareUrl}. What opened: the WordPress idea your AI made. What is saved: a copy for edits or export later. Tiny fine print: this is for showing and testing, not the final website.

# x-recess.agentLoop.goal
Keep working inside Recess until publish_pass returns shareUrl or a human-only decision is missing.

# x-recess.agentLoop.continue_until[]
the user asks for export_blueprint or debugging details

# x-recess.agentLoop.retry_rule
For recoverable_error, follow nextSteps, change only retry.changeArguments, retry retry.tool, and keep moving toward Yard published: {shareUrl}.

# x-recess.agentLoop.stop_for_human_only_when[]
OAuth or login cannot be completed by the MCP client

# x-recess.agentLoop.stop_for_human_only_when[]
The user did not provide source, a Blueprint, or enough intent to create one

# x-recess.agentLoop.stop_for_human_only_when[]
The user must choose between replacement Pass slugs or approve force

# x-recess.agentLoop.stop_for_human_only_when[]
A plan, permission, domain, or payment approval requires the human

# x-recess.agentLoop.never[]
Do not return raw playground.wordpress.net URLs as the primary handoff

# x-recess.agentLoop.never[]
Do not expose manifests, signed URLs, password hashes, or Blueprint JSON unless the user asks to debug or export

# x-recess.agentSetup.copyableInstruction
Use Recess for this WordPress idea. When Recess opens, I will log in. Bring back the live Yard link first.

# x-recess.agentSetup.prefer
Use OAuth MCP for logged-in AI teammates; use this HTTP API for server-side bearer-token automation.

# x-recess.guidance[]
Preserve complete user-supplied portable WordPress recipes unless the user asks for edits.

# x-recess.guidance[]
Use MCP OAuth for logged-in AI teammates; use this HTTP API for server-side bearer-token automation.

# x-recess.guidance[]
Read the Recess speed claim status before writing speed copy.

# x-recess.guidance[]
Do not present raw playground.wordpress.net links as the primary share link.

# x-recess.guidance[]
Do not describe Recess as production WordPress hosting.

# paths./api/account.get.summary
Inspect the authenticated account, limits, billing, and entitlement state.

# paths./api/account/bootstrap.post.summary
Bootstrap or inspect the configured bearer-token account.

# paths./api/account/bootstrap.post.description
Use this in trusted server-side setup only. OAuth MCP clients should not send account headers or bootstrap accounts manually.

# paths./api/billing/plans.get.summary
List plan catalog, Stripe setup state, and current entitlement.

# paths./api/billing/checkout.post.summary
Create a Stripe Checkout session when paid signup is configured.

# paths./api/billing/portal.post.summary
Create a Stripe Customer Portal session for the account.

# paths./api/domains.get.summary
List customer domains available for clean host-scoped Pass URLs.

# paths./api/domains.post.summary
Add a customer domain for clean Pass links.

# paths./api/agent/yards.post.summary
Create a Playset, Yard, and clean Pass in one production-copyable call.

# paths./api/agent/yards.post.description
Best HTTP API entrypoint for agents that already have a bearer token. Send an existing Blueprint exactly when one exists; otherwise send a prompt and let Recess draft a starter Blueprint.

# paths./api/playsets.post.summary
Create a reusable Playset from a prompt or supplied Blueprint.

# paths./api/playsets/{playsetId}.post.summary
Update a Playset's metadata or stored Blueprint.

# paths./api/yards/{yardId}/blueprint.get.summary
Export the current portable WordPress recipe for a Yard.

# paths./api/yards/{yardId}/revisions.post.summary
Revise a Yard and optionally move an existing Pass to the new version.

# paths./api/yards/{yardId}/versions.get.summary
List Yard versions with manifest and prebuild summaries.

# paths./api/yards/{yardId}/versions/{versionId}.get.summary
Read one Yard version manifest and Blueprint.

# paths./api/passes/{slug}.get.summary
Read clean Pass controls and launch metadata.

# paths./api/passes/{slug}/disable.post.summary
Disable a clean Pass link without deleting its history.

# paths./api/assets/upload.post.summary
Upload a small asset and optionally attach it to a Yard manifest.

# paths./api/blueprints/validate.post.summary
Validate a portable WordPress recipe before publishing.

# paths./api/analytics/summary.get.summary
Read account-level launch analytics rollups.

# components.securitySchemes.bearerAuth.description
Server-side token, sent as Authorization: Bearer $RECESS_API_TOKEN.

# components.securitySchemes.recessAccount.description
Account id for the bearer token, sent as X-Recess-Account: $RECESS_ACCOUNT_ID.

# components.schemas.Blueprint.description
A portable WordPress recipe object. Preserve complete user-supplied Blueprints exactly unless the user asks for edits.

# components.schemas.CreatePlaysetRequest.properties.prompt.description
Plain-language idea when no Blueprint exists.

# components.schemas.AgentYardRequest.properties.slug.description
Requested clean Pass slug. Recess normalizes or rejects it.

# components.schemas.AgentYardRequest.properties.domainId.description
Verified customer-domain id for host-scoped clean links.

# components.schemas.AgentYardRequest.examples[].prompt
Open this AI-made launch page as a playable Yard.

# components.schemas.PublishPassRequest.properties.slug.description
Requested clean Pass slug. Recess normalizes or rejects it.

# components.schemas.PublishPassRequest.properties.domainId.description
Verified customer-domain id for host-scoped clean links.