dryRun, expectedVersion and confirmation tokens. All tools require the write:prompts scope and the Manager role. Examples use synthetic data.
create_prompts needs a confirmation token only when it puts prompts under monitoring, because that adds recurring credit use. The preview reports the amount. update_prompt always needs one, because it changes or archives an existing prompt. bulk_update_prompts needs one too, except for a plain restore of archived prompts that does not raise credit use. Topics and tags cannot be deleted through MCP: delete them from the dashboard or with the REST API.
Branded and Non-branded are system tags that Qwairy sets on each prompt from its text, in a workspace created from v1.21. Their names are reserved, whatever the case: create_tag with either name, update_tag renaming a tag to either name, and update_tag on one of the two system tags are refused with INVALID_REQUEST, including in a dryRun preview. In create_prompts, update_prompt and bulk_update_prompts, the ids of these two tags in tagIds are ignored, and a tag replacement keeps the system tag the prompt carries. When update_prompt changes the text, Qwairy sets the system tag again from the new text.
create_prompts
Create 1 to 20 prompts. Monitored prompts add a recurring credit use shown in the preview.Parameters
Example
update_prompt
Change the text, topic, tags, frequency, countries or models of a prompt, archive it or restore it. Send only the fields you want to change. Every call needs a confirmation token from a preview.Parameters
Example
bulk_update_prompts
Apply one operation to up to 20 prompts. Each prompt needs its expected version, and version mismatches are reported per item. A confirmation token is required, except for a plain restore of archived prompts that does not raise credit use.Parameters
Inspect the result of every item. A bulk call can update some prompts and report others as unchanged or not found.
Example
create_topic and update_topic
create_topic creates a topic in a workspace. update_topic renames one.
Parameters
Example
create_tag and update_tag
create_tag creates a tag. update_tag renames or recolors one.
Example
Related
- Discovery tools to resolve topic and tag IDs.
- Prompt suggestions to create prompts from generated ideas.

