All pages
Start: OverviewStart: QuickstartStart: Getting startedStart: Test installsConcepts: ManifestConcepts: AuthenticationConcepts: VersioningCapabilities: Home blocksCapabilities: Chat toolsCapabilities: Channel connectorsAI agents: MCP serverReference: REST APIReference: WebhooksReference: Rate limitsPolicies: Billing and payoutsPolicies: Listing requirements
Test installs
You can test your app end to end before your listing is live.
- Save a draft version under Versions on your app page (the manifest validator runs on save).
- Tap Preview at the top of your app page to open
/marketplace/<slug>. Draft listings are visible only to you. - Tap Install: as the app’s developer, you can install a draft version. The install runs the full production flow:
installation.createdis POSTed to your webhook with a one-timeinstall_code, the token endpoint issues real tokens and block sessions are signed. - Turn on On your Home from the app’s page in Your apps (or add it in Your Home under Add a section > Apps). Your Home renders the block the same way a Visitor sees it.
- For chat tools, send a message in a chat with your own account or a test Visitor that triggers your tool through craving AI.
When you finish testing, open Your apps, select the app and tap Remove app. Installing again mints a fresh install code.
Local development
- Every manifest URL must use
https://on a public hostname. Use a tunnel (such as Cloudflare Tunnel or ngrok) to expose your local server and add the tunnel origin toorigins. - The automated reviewer probes your URLs when you submit a version, so keep your tunnel running during submission.
- Every request craving sends is signed with the webhook secret minted when you saved your webhook URL. Rotate the secret in the Webhook sheet if it ever leaks into logs.
Sandbox money
Paid plans run real Stripe checkouts. Test your install flow with no plan or a Free plan first, then add paid plans before publishing.