Skip to content

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 ​

Start from the scaffold ​

bash
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:

ToolWhat it does
search_docsSearches this documentation offline.
validate_app_manifestValidates app.toml and returns the errors to fix.
get_graphql_schemaFetches the Developer API schema for the current version.
run_graphqlRuns queries and mutations against your development store install.
list_webhook_topicsLists every webhook topic with its payload shape.
get_webhook_deliveriesLists real, signed deliveries received by your dev install.
replay_webhookRe-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.

© Stayblox — Developer Platform