Automate

Automate a practice run

Run the same bounded lifecycle from CI or hosted MCP without repository-only steps.

Use this when

Use this when the five-step practice loop must run repeatably outside the dashboard.

Before you start

Create a workspace API key for direct API calls, or authorize hosted MCP with OAuth. Keep control credentials out of the agent process; the agent receives only the store Admin URL and token.

Steps

Package-free CI: call the documented practice HTTP endpoints with your existing HTTP client; preserve failed artifacts and return a CI exit code owned by your policy.
Hosted MCP: connect with OAuth 2.1 to stateless Streamable HTTP /mcp. Clients without remote transport support can bridge to the hosted URL with npx -y mcp-remote <hosted MCP URL>; configure OAuth or a workspace key as standard Bearer authorization, never as a process argument.
Start, inspect status, capture checkpoints when needed, copy practiceRun.advanceCursor unchanged into advance, finish or cancel, and fetch the receipt.

Success looks like

Automation emits only copyable or downloadable artifacts, preserves the full receipt boundary, and never passes the workspace key to the agent under test.

If it fails

If a control call fails, record its status and bounded response, refresh status for the server-owned practiceRun.advanceCursor, and stop rather than manufacturing a successful artifact. The shopper-facing practice-store /api/mcp is a separate Storefront data plane, not the hosted control plane.

Next action

Add a Configured Gate signal for the concluded receipt; keep any money threshold in your own CI step.