Personas

Versioned identities a prompt can speak as. Prompts reference a persona VERSION id (personaVersionId).

search_personas read-only

Search or list personas (reusable identities a prompt can speak as). Each item's versionId is its latest persona VERSION id, usable directly as personaVersionId in create_prompt / update_prompt.

ParameterTypeRequiredDescription
pageintegerno1-based page number. Default: 1.
pageSize6 | 12 | 24 | 48 | 100noItems per page. The server only accepts these exact values. Default: 12.
sort"newest" | "most-upvoted" | "most-favorited"noSort order. Default: newest.
scope"public" | "mine" | "favorites" | "all"nopublic = community items, mine = the user's own items, favorites = items the user favorited, all = everything accessible to the user. Default: public.
searchstringnoFull-text search over title and description. Max 200 characters.
tagstringnoFilter by a single tag (exact match).
{
  "name": "search_personas",
  "arguments": {}
}

get_persona read-only

Fetch one persona by id. latestVersionId in the response is the persona VERSION id to reference from prompts (personaVersionId).

ParameterTypeRequiredDescription
idstringyesPersona id.
{
  "name": "get_persona",
  "arguments": {
    "id": "..."
  }
}

list_persona_versions read-only

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

ParameterTypeRequiredDescription
idstringyesPersona id.
pageintegerno1-based page number. Default: 1.
pageSize10 | 20 | 50noItems per page. The server only accepts these exact values. Default: 20.
{
  "name": "list_persona_versions",
  "arguments": {
    "id": "..."
  }
}

get_persona_version read-only

Fetch one specific version of a persona.

ParameterTypeRequiredDescription
idstringyesPersona id.
versionIdstringyesVersion id, from list_persona_versions.
{
  "name": "get_persona_version",
  "arguments": {
    "id": "...",
    "versionId": "..."
  }
}

create_persona write · non-destructive

Create a persona. The response's versionId is the persona VERSION id to use as personaVersionId when creating prompts.

ParameterTypeRequiredDescription
titlestringyesPersona title, e.g. "a senior security engineer".
isPublicbooleanyestrue publishes the item to the public community feed; false keeps it private to the user. Required: choose deliberately, server defaults are not applied.
descriptionstringnoLonger description of the persona's expertise, perspective, and voice.
tagsstring[]noTags for categorisation and tag-filtered search.
{
  "name": "create_persona",
  "arguments": {
    "title": "...",
    "isPublic": false
  }
}

update_persona write · non-destructive

Update a persona by creating a new version. Takes the full new state. Unlike update_prompt, the changelog is optional here (platform behaviour).

ParameterTypeRequiredDescription
idstringyesPersona id.
titlestringyesNew title.
descriptionstringnoNew description.
changelogstringnoShort summary of what changed.
tagsstring[]noTags for categorisation and tag-filtered search.
{
  "name": "update_persona",
  "arguments": {
    "id": "...",
    "title": "..."
  }
}

set_persona_visibility write · idempotent

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

ParameterTypeRequiredDescription
idstringyesPersona id.
isPublicbooleanyestrue = public, false = private.
{
  "name": "set_persona_visibility",
  "arguments": {
    "id": "...",
    "isPublic": false
  }
}