> ## 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.

# create_persona

> MCP tool — save a generated persona to your account

Takes the persona data produced by [`chat_persona`](/agent/mcp-tools/chat-persona) and saves it to your Percio account. Once created, the persona is immediately available for test runs in both the web app and the agent.

## Inputs

| Field              | Type              | Description                               |
| ------------------ | ----------------- | ----------------------------------------- |
| `name`             | string            | Persona's full name.                      |
| `mainObjective`    | string            | Main life or work goal, 30–200 chars.     |
| `techLevel`        | number            | Tech expertise, 1–5.                      |
| `occupation`       | string            | Job title or role.                        |
| `description`      | string            | 2–3 sentence background.                  |
| `systemPrompt`     | string            | Full evaluation system prompt.            |
| `focusAreas`       | string\[]         | 3–5 things the persona pays attention to. |
| `painPoints`       | string\[]         | 2–4 frustrations the persona brings.      |
| `behavioralTraits` | string\[]         | 3–5 personality traits.                   |
| `deviceContext`    | string            | Primary device and usage context.         |
| `emoji`            | string (optional) | Emoji for the persona.                    |

Every field maps directly to the persona fields in the web app — see [Creating personas](/personas/creating-personas) for the full field guide.

## Output

The saved persona, including its new UUID, plus a ready-to-use CLI command for running a test with it:

```bash theme={null}
percio test --persona-id <uuid> --url <url> --flow <task>
```

## When to use it

* After a `chat_persona` loop returns `isComplete: true`, to save the generated persona.
* Directly, if Cursor has enough structured input to skip the conversation.

## Cost

Creating a persona is free. It does not consume credits.

## Typical MCP flow

1. User asks Cursor to create a persona.
2. Cursor calls [`chat_persona`](/agent/mcp-tools/chat-persona) and relays the Q\&A.
3. When the conversation returns `isComplete: true`, Cursor calls `create_persona` with the generated data.
4. Cursor confirms the persona was saved and optionally offers to run a test with it.

## What's next

* [chat\_persona](/agent/mcp-tools/chat-persona)
* [run\_usability\_test](/agent/mcp-tools/run-usability-test)
* [Managing personas](/personas/managing-personas)