MCP tools
All tools require Authorization: Bearer prm_…. Requests without a valid token get 401.
search_prompts
Section titled “search_prompts”Search prompts you can access. Returns a JSON list of id, title, description, tags, visibility, workspace, author, updated_at.
| Argument | Type | Default | Description |
|---|---|---|---|
query |
string | — | Matches title, note or prompt text (case-insensitive). |
tag |
string | — | Only prompts with this tag. |
include_public |
boolean | false |
Also include other users’ public prompts. |
limit |
integer 1–100 | 20 |
Maximum results. |
get_prompt
Section titled “get_prompt”Return one prompt as Markdown: title, note, tags and the full text.
| Argument | Type | Description |
|---|---|---|
id |
uuid | Prompt id from search_prompts. |
save_prompt
Section titled “save_prompt”Create a new private prompt in your personal notebook. Returns its id and link.
| Argument | Type | Description |
|---|---|---|
title |
string (≤140) | Required. |
content |
string | Required. The prompt text. |
description |
string | Optional short note. |
tags |
string[] (≤12) | Optional. |
list_tags
Section titled “list_tags”List the tags on your own prompts with how many prompts use each, most-used first. No arguments.
list_design_templates
Section titled “list_design_templates”List published design templates. Returns a JSON list of slug, title, description, category, style_tags, palette, copy_count, url, cover_url and demo_url (no prompt text).
| Argument | Type | Default | Description |
|---|---|---|---|
query |
string | — | Matches title or description (case-insensitive). |
style |
string | — | Only templates with this style tag, e.g. minimal, dark. |
limit |
integer 1–50 | 20 |
Maximum results. |
get_design_template
Section titled “get_design_template”Return one template’s full design prompt as Markdown, headed by its page, live demo and palette. Counts as a copy.
| Argument | Type | Description |
|---|---|---|
slug |
string | Required. From list_design_templates or the /templates/<slug> URL. |
variables |
object | Optional values for the prompt’s {{placeholders}}, e.g. { "product_name": "Acme" }. Any left out stay as {{…}} and are listed under Still to fill, so the assistant can ask for them. |
Both tools answer Design templates are turned off while the design_templates flag is off.