Before you start
- An active Business, Agency Business or Enterprise plan.
- A connection with
read:promptsandwrite:prompts, and a Manager or Owner role. See MCP write access. - A workspace, with its topics already created if you want a generation per topic.
Steps
1
Start a generation
The assistant calls A workspace can start 3 workspace generations and 10 topic generations over a rolling 24 hours, with at most one workspace generation and one per topic running at a time. Reuse
generate_prompt_suggestions. Use source: manual for the whole workspace, or source: topic with a keywordId:requestId for a lost response; change it for a new generation, including after FAILED.2
Wait for it to finish
The assistant polls
get_prompt_suggestion_run until the status is COMPLETED. A client that also uses the REST API can subscribe to prompt_suggestions.ready and prompt_suggestions.failed instead of polling. The event carries the generation ID in data.runId.3
Read the suggestions
get_prompt_suggestions returns the 20 recommendations by default, with a score, a reason and a tracked flag. Pass limit, up to 500, to read more of the pool; total gives its size. Use focus to reorder by funnel stage: DISCOVERY, CONSIDERATION, PERCEPTION or AUTHORITY. Skip suggestions that are already tracked, which means active and monitored. A suggestion equivalent to an archived or paused prompt reads false, and accepting it reactivates that prompt.4
Choose and preview
Pick up to 20 suggestions. The assistant calls Qwairy returns the outcome of each suggestion, the recurring credit use of the monitored prompts in
accept_prompt_suggestions with dryRun set to true, or without a token:credits.dailyChange, the cost of the collection the next scheduler pass would start in credits.oneOff, and a confirmationToken.5
Confirm
If both amounts are acceptable, confirm. The assistant repeats the call with the same arguments and the token. The token is single use, valid for 10 minutes, and rejected if the arguments or the cost changed. Your MCP client may ask for its own approval too.
6
Check the prompts
List the prompts of the workspace and confirm the new ones are there with the expected topic and monitoring state.
Example conversation
Limits
- Suggestions are ideas based on your workspace. They do not predict what an AI assistant will answer.
- Accepting uses suggestions of the latest generation. IDs are bound to content and taxonomy: read them again after regeneration, and never construct them yourself.
- A suggestion can be created, already tracked, not found or invalid: check every item.
- Accepting starts no collection itself, but on a
LIVEworkspace it can make new or reactivated prompts due at the next scheduler pass. That collection uses credits once; the preview shows the amount incredits.oneOff.
Related
- Prompt suggestion write tools
- Generate prompt suggestions for the REST equivalent.

