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

# chat_persona

> MCP tool — build a persona through conversation

The persona builder. Like [`chat_scenario`](/agent/mcp-tools/chat-scenario), this is a conversational loop between **you** and Percio's persona assistant, with the MCP client as a strict **relay**. When the persona is complete, the client passes the generated data to [`create_persona`](/agent/mcp-tools/create-persona) to save it.

## Inputs

| Field      | Type  | Description                                                                                                                                                        |
| ---------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `messages` | array | Full conversation history. Each entry has `role` (`user` or `assistant`) and `content` (string). Append each new message and resend the whole array on every call. |

## Output

The assistant's next response. Includes an `isComplete` boolean and, once finished, the generated persona data ready to pass to `create_persona`.

## The relay rule

Same as `chat_scenario`: Cursor must show the assistant's questions to you verbatim and wait for your answer. It should never invent details about the persona — only your actual words go in as `role: "user"` messages.

## Typical loop

1. Client calls `chat_persona` with an opening `role: "user"` message describing the persona you want.
2. Assistant replies with follow-up questions — occupation, device context, pain points, tech level, etc.
3. Client relays the questions to you.
4. You answer.
5. Client appends to the history and calls again.
6. Repeat until `isComplete: true`.
7. Client calls [`create_persona`](/agent/mcp-tools/create-persona) with the generated data to save the persona.

## Example prompt in Cursor

> "Create a Percio persona for a 35-year-old bakery owner who mostly uses Instagram on her phone to run her business."

Cursor will call `chat_persona` with that opening line and start the Q\&A.

## When to use it

Whenever you want to create a persona without leaving Cursor — or when a scenario calls for a persona you don't have and you want to create one on the spot.

## What's next

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