persona_get

Fetch one of a brand's personas — who it is talking to, in their own words — so an agent can write for someone in particular.

Fetches a single Persona by the pair that addresses it: its Brand’s slug and its own.

A Persona is an audience archetype — who a brand is talking to. It is the counterpart to the Brand’s own sections, which say who it is talking as. Discover a brand’s personas with brand_get; there is no separate list tool, because the brand bundle already carries them.

Input

Field	Type	Required	Description
`brand_name`	`string`	yes	The slug of the brand that owns the persona.
`persona_name`	`string`	yes	The persona slug. Unique within its brand, so it must be paired with `brand_name`.

Output

{ persona }, carrying slug, name, description, revision, the age range, and four context sections:

Section	What belongs in it
`profile`	Who they are: life stage, situation, role, context
`motivations`	What they want: jobs to be done, triggers, outcomes
`frictions`	What stops them: objections, doubts, perceived risk
`language`	The words they use for the problem — their verbatims

Each section is free-form markdown and independently optional — one you haven’t written is null, which is normal rather than an error.

ageMin and ageMax are independently nullable: ageMin alone means “and older”, ageMax alone means “and younger”, and both null means the persona is not defined by age at all.

Example

“Write three ad headlines for Acme Running, aimed at Marathon Maya.”

persona_get({ brand_name: 'acme-running', persona_name: 'marathon-maya' });
// → { persona: { slug: 'marathon-maya', ageMin: 30, ageMax: 44,
//                frictions: 'Thinks carbon plates are a gimmick…', … } }

The agent reads frictions and language alongside the brand’s voice, so the headline answers a real objection in words the reader would use.

Requires the brand:read scope — a persona is part of its brand’s context, not a separate permission.

Reference

Fetch one of a brand’s personas — an audience archetype describing who the brand talks to. Returns the full context (profile, motivations, frictions, language) and the age range. Unwritten sections are null. Echo the revision back as base_revision when updating. Personas are listed inside brand_get; there is no separate list tool.

Input

Argument	Type	Required	Description
`brand_name`	string	yes	The slug of the brand that owns the persona.
`persona_name`	string	yes	The persona slug. Unique within its brand, so it must be paired with brand_name.

Failure codes

A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.

not_found
forbidden
invalid_request
internal_error

Scope

The token must hold brand:read. Auth & scopes lists each scope.

Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

Read-only. The tool changes nothing.
Closed world. The tool reads and writes the data of AdCrunch only.