Skip to main content
Returns every persona on your account. This is always the first step in the MCP test flow: a test requires a persona UUID, and this tool is how Cursor (or any MCP client) discovers what’s available.

​
Inputs

None.

​
Output

A JSON array of personas. Each entry contains the persona’s id, name, emoji, occupation, tagline, and tech expertise — enough for the AI client to present them to you for selection.

​
Behavior

  • If your account has zero personas, the client should offer to create one via chat_persona + create_persona before running a test.
  • Results come from the Percio API in real time — personas you create in the web app show up immediately.

​
Typical MCP flow

  1. Cursor calls list_personas and presents the results.
  2. You pick one, or ask to create a new one.
  3. Cursor moves on to chat_scenario to build a scenario.
  4. Cursor calls run_usability_test with the chosen persona id.

​
Example prompt in Cursor

“List my Percio personas.”
or simply
“Run a usability test on http://localhost:3000.”
— the client will call list_personas as part of orchestrating the run.

​
What’s next