> ## Documentation Index
> Fetch the complete documentation index at: https://docs.percio.app/llms.txt
> Use this file to discover all available pages before exploring further.

# list_personas

> MCP tool — list your cloud personas

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`](/agent/mcp-tools/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`](/agent/mcp-tools/chat-scenario) to build a scenario.
4. Cursor calls [`run_usability_test`](/agent/mcp-tools/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](http://localhost:3000)."

— the client will call `list_personas` as part of orchestrating the run.

## What's next

* [chat\_scenario](/agent/mcp-tools/chat-scenario)
* [chat\_persona](/agent/mcp-tools/chat-persona)