list_personas
Paginated list of the archetypal users a project is built for, with their goals, frustrations, habits, proficiency and devices, narrowed by search words or archived state.
Return the personas of one project in the project's order: the named, sketched users the analyst wrote the product for, each with a tagline, a role title, four prose fields (demographics, goals, frustrations, behaviours), a tech proficiency, the devices they use and a quote. Read it before drafting a story, a use case or a test, so you write for the people the analyst sketched rather than a generic user, and to find the persona_id a story will name.
Narrow with search (words in the name, the tagline or the role title) and archived (true for archived personas only, false for live ones; omit for both).
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project whose personas to list.
searchstringoptionalWords the name, the tagline or the role title must contain.
archivedbooleanoptional`true` lists archived personas only, `false` live ones only; omit for both.
limitintegeroptionalPersonas per page (1..100, default 25).
1max100pageintegeroptional1-indexed page number.
1What it returns
{ "data": [ { "id": "b8c9d0e1-f2a3-4b4c-9d5e-6f7a8b9c0d12", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "name": "Busy Buyer", "tagline": "Orders for three branches between meetings.", "role_title": "Procurement officer", "demographics": "<p>Mid-forties, twelve years at the company, works from the regional office.</p>", "goals": "<ul><li>Reorder last month's basket in two minutes.</li></ul>", "frustrations": "<ul><li>Has to call support to change a delivery address.</li></ul>", "behaviours": "<p>Works on a laptop at the desk and a phone on the warehouse floor.</p>", "tech_proficiency": "medium", "devices": ["Laptop", "Phone"], "quote": "Just let me repeat last month's order.", "position": 0, "archived_at": null, "created_at": "2026-10-20T09:20:00+00:00", "updated_at": "2026-10-27T11:30:00+00:00" } ], "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }}How it fails
RESOURCE_NOT_FOUNDunknown project_id, or a project outside the token's scope or the person's visibility.
TOKEN_MISSING_ABILITYtoken lacks persona:view-any.
How is this guide?
Last updated on