personas

---

title: Personas sidebar_label: Personas (5) sidebar_position: 13 doc_type: reference

Personas

Overview

Explore profiles, skills, and demographics of your contacts.

Prerequisites

• API key with the MCP preset and required scopes
• Configured MCP client (see Configuration)

Quick start examples

Search and analyze profiles

1. Search profiles by skills :

{
  "name": "persona_search",
  "arguments": {
    "query": "developpeur senior"
  }
}

2. Find profiles matching specific skills :

{
  "name": "persona_skills_match",
  "arguments": {
    "skills": [
      "TypeScript",
      "React",
      "Node.js"
    ]
  }
}

3. View demographic data :

{
  "name": "persona_demographics",
  "arguments": {}
}

---

persona_compare_cohorts

Compare two persona cohorts side by side on demographics, skills, and geography.

USE WHEN:

• Need to compare two groups of personas
• Want to analyze differences between segments RETURNS: comparison with deltas for each dimension.

Scope	mcp.read
Read-only	Yes
Destructive	No
Idempotent	Yes

Parameters

Parameter	Type	Required	Description
cohortA	object	Yes	First cohort filter criteria
cohortB	object	Yes	Second cohort filter criteria
dimensions	array	No	Comparison dimensions (demographics, skills, geography)

Response

Field	Type	Description
cohortA	object
cohortB	object
deltas	object

Related tools : persona_search, persona_demographics, persona_skills_match

---

persona_demographics

Get demographic statistics for persona records (age pyramids, gender ratios, education levels).

USE WHEN:

• Need aggregated demographic breakdowns
• Want age, gender, or education distribution RETURNS: demographic breakdown with counts and percentages.

Scope	mcp.read
Read-only	Yes
Destructive	No
Idempotent	Yes

Parameters

Parameter	Type	Required	Description
dimension	string	No	Breakdown dimension (age, gender, education, all) (default : "all")
filters	object	No	Optional filters (location, skills)

Response

Field	Type	Description
ageDistribution	array
genderRatio	object
educationLevels	array
total	number

Related tools : persona_search, persona_geographic_distribution

---

persona_geographic_distribution

Get geographic distribution of personas.

USE WHEN:

• Need to see where personas are located
• Want regional or city-level breakdown RETURNS: geographic breakdown with counts per region/city.

Scope	mcp.read
Read-only	Yes
Destructive	No
Idempotent	Yes

Parameters

Parameter	Type	Required	Description
filters	object	No	Optional filters
granularity	choice (country, region, city)	No	Level of detail (country, region, city) (default : "region")

Response

Field	Type	Description
distribution	array
total	number

Related tools : persona_search, persona_demographics

---

persona_search

[DISCOVERY] Search personas by name, skills, occupation, or location.

USE WHEN:

• Need to find personas matching specific criteria
• Want to browse available persona records RETURNS: matching personas with key attributes.

Scope	mcp.read
Read-only	Yes
Destructive	No
Idempotent	Yes

Parameters

Parameter	Type	Required	Description
limit	number	No	Maximum results (default : 50)
location	string	No	Filter by location
query	string	No	Search query
skills	array	No	Filter by skills

Response

Field	Type	Description
personas	array
total	number

Example

{
  "name": "persona_search",
  "arguments": {
    "query": "developpeur senior"
  }
}

Related tools : persona_demographics, persona_skills_match

---

persona_skills_match

Match personas by skills criteria with scoring.

USE WHEN:

• Need to find personas with specific skill combinations
• Want scored matching against a skill profile RETURNS: matching personas ranked by skill match score.

Scope	mcp.read
Read-only	Yes
Destructive	No
Idempotent	Yes

Parameters

Parameter	Type	Required	Description
requiredSkills	array	Yes	Required skills
limit	number	No	Maximum results (default : 20)
minScore	number	No	Minimum match score (0-1) (default : 0.5)
preferredSkills	array	No	Preferred but not required skills

Response

Field	Type	Description
matches	array
total	number

Related tools : persona_search, persona_demographics

Need help?

Contact us: Support and contact.