Skip to content

MCP tools

All tools require Authorization: Bearer prm_…. Requests without a valid token get 401.

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.

Return one prompt as Markdown: title, note, tags and the full text.

Argument Type Description
id uuid Prompt id from search_prompts.

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 the tags on your own prompts with how many prompts use each, most-used first. No arguments.

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.

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.