Which tools use messages
Only the three AI design tools draw on your message allowance:ai-design-screensai-generate-screen-variantai-edit-screen-variant
get-screen-jsx, add-screen-jsx, and replace-screen-jsx, managing design guidelines, uploading attachments, importing from Figma, and checking your plan with get-plan-details.
The server also tells connected agents which tools are paid, so your agent can factor that in before it calls them.
How limits work
Limits are per-feature (the primary feature ismessages). Each plan defines:
- A daily limit — resets at 00:00 UTC every day
- A monthly limit — resets on the date of the account sign up or paid subscription start each month
Checking your quota
Callget-plan-details to see your current plan, limits, usage, and remaining quota. It’s free to call, so your agent can check before kicking off a batch of generations.
Actual limit values depend on your plan — run the tool to see your specific numbers. See Tools reference for the full response shape.
Per-request limits (all plans)
These limits are enforced at the request level regardless of plan:When a call doesn’t use a message
A message is only used when Flowstep actually builds or changes screens. If a generation fails — due to a server error or an invalid input — it does not consume a message. Ifai-design-screens returns status: "chat" (a reply without building), no message is used either.
When an AI design tool call times out after 180 seconds, the MCP server stops waiting for the result, but the generation can still finish in the background. If some screens were already built, the call returns them instead of an error. Either way, call
list-screens to check whether more screens landed before you retry, so you don’t generate them twice.