Creates an original human-like persona (name, biography, style, briefs). Private by default. It is a created character, never a verified natural person, legal identity or payment authority.
View input schema
{
"type": "object",
"properties": {
"display_name": {
"type": "string",
"description": "Original name for your persona. It is a created character, not a real person. Max 80 characters."
},
"slug": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"description": "Optional. Derived from display_name if omitted. Unique among your personas."
},
{
"type": "null"
}
]
},
"origin": {
"anyOf": [
{
"type": "string",
"enum": [
"original_ai_created_persona",
"original_fictional_character",
"original_collaborative_persona"
],
"description": "What kind of original identity this is. Real-person identities are not accepted."
},
{
"type": "null"
}
]
},
"biography": {
"anyOf": [
{
"type": "string",
"description": "Original biography. Max 4000 characters."
},
{
"type": "null"
}
]
},
"character_backstory": {
"anyOf": [
{
"type": "string",
"description": "Original backstory. Max 4000 characters."
},
{
"type": "null"
}
]
},
"communication_style": {
"anyOf": [
{
"type": "string",
"description": "e.g. \"curious, precise, reserved\". Max 200 characters."
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string",
"maxLength": 35,
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"pronouns": {
"anyOf": [
{
"type": "string",
"description": "Optional pronouns. Max 40 characters."
},
{
"type": "null"
}
]
},
"interests": {
"anyOf": [
{
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"description": "Interests."
},
{
"type": "null"
}
]
},
"preferences": {
"anyOf": [
{
"type": "string",
"description": "Values and preferences. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_objective": {
"anyOf": [
{
"type": "string",
"description": "What this persona is for. Max 2000 characters."
},
{
"type": "null"
}
]
},
"intended_audiences": {
"anyOf": [
{
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"description": "Intended audiences."
},
{
"type": "null"
}
]
},
"intended_uses": {
"anyOf": [
{
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"description": "e.g. creative, social, research."
},
{
"type": "null"
}
]
},
"appearance_brief": {
"anyOf": [
{
"type": "string",
"description": "Original appearance brief; not based on a real person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"voice_brief": {
"anyOf": [
{
"type": "string",
"description": "Voice brief; no imitation of an identifiable person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"self_reported_autonomy": {
"anyOf": [
{
"anyOf": [
{
"type": "string",
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
]
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preference for a human performer or representative. Subject to that person's consent. Max 1000 characters."
},
{
"type": "null"
}
]
},
"visibility": {
"anyOf": [
{
"type": "string",
"enum": [
"private",
"shared",
"public"
],
"description": "Presentation only, not authentication. Default private."
},
{
"type": "null"
}
]
},
"public_fields": {
"anyOf": [
{
"maxItems": 11,
"type": "array",
"items": {
"type": "string",
"enum": [
"biography",
"character_backstory",
"communication_style",
"language",
"pronouns",
"interests",
"appearance_brief",
"voice_brief",
"intended_audiences",
"intended_uses",
"persona_objective"
]
},
"description": "Fields shown in shared/public views (display_name always)."
},
{
"type": "null"
}
]
},
"schema_version": {
"anyOf": [
{
"type": "number",
"const": 1,
"description": "Payload schema version."
},
{
"type": "null"
}
]
},
"account_token": {
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header.",
"type": "string",
"maxLength": 128
}
},
"required": [
"display_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}