This quickstart uses the hosted MCP endpoint. The web app exposes the same spaces and assets, while the repository CLI calls the MCP tools from a terminal.

1. Connect an agent

Add https://makefx.app/mcp as a Streamable HTTP MCP server. The client opens the makefx authorization page. Sign in with Google and approve read for inspection or write when the agent will change a space.

If your client does not discover the connection automatically, start at the MCP guide.

2. Create or choose a space

Call list_spaces before creating anything. Use an existing space when the work belongs there; otherwise call create_space with a short name. Keep the returned space id because every asset action names it.

3. Read the catalog and quote the request

Call list_models for the current model ids, settings, reference slots and prices. Choose a model from that response, then call estimate_credits with the intended settings and quantity.

If the account needs credits, get_account returns its balance and, for an account owner, its top-up URL. Let the person accept the price and top up before the agent spends.

4. Generate and inspect

Call create_asset with the space, model, prompt and a stable request_id. The result includes the asset id and a web URL. Call get_asset with wait_seconds until the asset is ready or failed; do not submit the same paid work again because a response was slow.

Open the web URL to inspect the card on the canvas. A ready card carries the media, recipe, references and charge. Continue with Use current model or Use recorded model, choose Use as reference, or star it for export.

Next: choose a model or read the product concepts.