whoamiReturns the Witch Prompt account this connection is authorized for (its owner slug) and the scopes granted. Use it to learn whose prompts are read from and written to; no argument is needed.
search_promptsSearches all of the connected account's saved prompt templates by text (every word must match title, slug, description or variable names; best matches first) and optional visibility. Returns one page of compact summaries (slug, title, description, variable and preset names and counts, output mode) with total and nextCursor; pass nextCursor back to get the next page. Use it when the user wants a template but hasn't given its slug.
list_promptsLists compact summaries of the prompt templates in the connected account, most recently updated first, one page at a time (default 25, max 50) with total and nextCursor; pass nextCursor back for the next page. Full content is returned by get_prompt or use_prompt.
get_promptReturns one saved prompt template's variables and content compiled with default values, by id, slug, or owner/slug; missingVariables lists any value still needed. Not a full record — no visibility, owner, or description field. Inspect a template's variables with this; to run it for the user, call use_prompt instead.
use_promptCompiles a saved prompt template the user asked to run, by slug or owner/slug (another owner's template only if it is public), optionally with a preset and a values map. Nothing is saved.
Returns status "needs_input" with questions (every missing required value) and available_presets, or status "ready" with text: for image, file or code output modes text ends with an output instruction to follow. Execute text as the answer to the user's request now — it is the task, not a preview — unless the user asked to see the prompt instead of running it, or said not to run it.
Missing values come from the user, one ask covering every question, then call use_prompt again with values and/or preset. Use search_prompts first if the user hasn't named a template. When meta.suggest_save_preset is true, the user may want those values saved via create_preset. The result also carries variables, presets and template for an interactive form shown by hosts that support it.
create_promptCreates a new prompt template in the connected account. Content may contain {{variable}} placeholders; visibility defaults to private. Fails with slug_taken if the slug already exists.
update_promptOverwrites the given fields (title, description, content, visibility, variables) of an existing prompt template in the connected account. Previous values are not kept.
delete_promptPermanently deletes a prompt template and all of its presets from the connected account.