Building apps with AI

AI coding agents can build Stayblox apps end to end: scaffold, explore the GraphQL API, handle webhooks, and validate the manifest, all through the Stayblox CLI's MCP server.

Machine-readable documentation

• /llms.txt is a compact index of this documentation.
• /llms-full.txt is the full corpus in one file.

Start from the scaffold

npm install -g @stayblox/cli
stayblox app init my-app

The scaffold ships AGENTS.md (structure and iteration loop) and .mcp.json (registers the stayblox mcp server).

The dev MCP server

Run stayblox login once, then start your agent. Tools useful for app work:

Tool	What it does
search_docs	Searches this documentation offline.
validate_app_manifest	Validates app.toml and returns the errors to fix.
get_graphql_schema	Fetches the Developer API schema for the current version.
run_graphql	Runs queries and mutations against your development store install.
list_webhook_topics	Lists every webhook topic with its payload shape.
get_webhook_deliveries	Lists real, signed deliveries received by your dev install.
replay_webhook	Re-delivers a recorded webhook to your local server.

A working loop

1. Ask the agent to add a capability, for example reacting to new bookings.
2. The agent reads the schema with get_graphql_schema, finds the topic with list_webhook_topics, and writes the handler.
3. The agent tests the handler by replaying a real delivery with replay_webhook.
4. After manifest changes, the agent runs validate_app_manifest before you push.