Skip to main content
Takes the persona data produced by 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

FieldTypeDescription
namestringPersona’s full name.
mainObjectivestringMain life or work goal, 30–200 chars.
techLevelnumberTech expertise, 1–5.
occupationstringJob title or role.
descriptionstring2–3 sentence background.
systemPromptstringFull evaluation system prompt.
focusAreasstring[]3–5 things the persona pays attention to.
painPointsstring[]2–4 frustrations the persona brings.
behavioralTraitsstring[]3–5 personality traits.
deviceContextstringPrimary device and usage context.
emojistring (optional)Emoji for the persona.
Every field maps directly to the persona fields in the web app — see 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:
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 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