Skip to main content
These tools manage the prompts a workspace monitors and the topics and tags that organize them. Read MCP write access first for plans, scopes, roles, 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