Prompts

Search, read, create, and version prompts. The platform compiles the final prompt text from the task and the referenced building blocks.

• search_prompts
• get_prompt
• list_prompt_versions
• get_prompt_version
• create_prompt
• update_prompt
• set_prompt_visibility

search_prompts read-only

Search or list prompts on prompty.tools. Returns summaries including the compiled prompt text. Use get_prompt for full details of a specific prompt.

{
  "name": "search_prompts",
  "arguments": {}
}

get_prompt read-only

Fetch one prompt by id, including its server-compiled prompt text (compiledPrompt), the task, referenced building blocks, tags, and version metadata.

{
  "name": "get_prompt",
  "arguments": {
    "id": "..."
  }
}

list_prompt_versions read-only

List the version history of a prompt (newest first).

{
  "name": "list_prompt_versions",
  "arguments": {
    "id": "..."
  }
}

get_prompt_version read-only

Fetch one specific version of a prompt, including the compiled prompt text as of that version.

{
  "name": "get_prompt_version",
  "arguments": {
    "id": "...",
    "versionId": "..."
  }
}

create_prompt write · non-destructive

Create a prompt from a task plus optional building-block references; the platform compiles the final prompt text server-side. Returns the new prompt's id - call get_prompt to retrieve the compiled text.

{
  "name": "create_prompt",
  "arguments": {
    "title": "...",
    "task": "...",
    "isPublic": false
  }
}

update_prompt write · non-destructive

Update a prompt by creating a new version. Takes the FULL new state (title, task, building-block references), not a partial diff; omitted building blocks are removed from the new version. Earlier versions remain accessible.

{
  "name": "update_prompt",
  "arguments": {
    "id": "...",
    "title": "...",
    "task": "...",
    "changelog": "..."
  }
}

set_prompt_visibility write · idempotent

Make a prompt public (community-visible) or private. Reversible.

{
  "name": "set_prompt_visibility",
  "arguments": {
    "id": "...",
    "isPublic": false
  }
}