Skip to main content
PE

Persona

v0.2.1API Key

KYC moderno developer-first — gran DX y workflows orientados a template. 4ª entrada de identidad (Unico BR / Onfido global / Jumio enterprise / Persona moderno).

20 herramientas2 env vars🌐 GLOBALestable en npm

Qué puede hacer tu agente

Persona le da a tu agente 20 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.

  • create_inquiryCreate a Persona inquiry — a verification session bound to an inquiry template you configured in the Persona dashboard. The template defines which verifications run (document, selfie, database, phone, etc). Returns an inquiry id and (for hosted flows) a one-time link for the end user.
  • retrieve_inquiryRetrieve an inquiry by id. Response includes overall status ('created' | 'pending' | 'completed' | 'expired' | 'failed' | 'needs_review' | 'approved' | 'declined') and embedded verifications / reports. Poll this to track progress.
  • list_inquiriesList inquiries, filterable by reference-id (your internal user id) or status. Useful for reconciling state or finding a user's inquiry history.
Ejemplo de llamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_inquiry", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-persona

Quickstart

Agregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "persona": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-persona"
      ],
      "env": {
        "PERSONA_API_KEY": "<your_persona_api_key>"
      }
    }
  }
}

Después de reiniciar, tu agente puede llamar cualquiera de las 20 herramientas de abajo — probá create_inquiry primero.

Variables de entorno · 2

Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.

PERSONA_API_KEY
obligatoriosecret

Persona API key. Sent as 'Authorization: Bearer <value>'.

PERSONA_API_VERSION
opcional

Persona API version pin (sent as 'Persona-Version' header). Defaults to '2023-01-05'.

Herramientas disponibles · 20

Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.

WRITEcreate_inquiry
Create a Persona inquiry — a verification session bound to an inquiry template you configured in the Persona dashboard. The template defines which verifications run (document, selfie, database, phone, etc). Returns an inquiry id and (for hosted flows) a one-time link for the end user.
READretrieve_inquiry
Retrieve an inquiry by id. Response includes overall status ('created' | 'pending' | 'completed' | 'expired' | 'failed' | 'needs_review' | 'approved' | 'declined') and embedded verifications / reports. Poll this to track progress.
READlist_inquiries
List inquiries, filterable by reference-id (your internal user id) or status. Useful for reconciling state or finding a user's inquiry history.
WRITEapprove_inquiry
Mark an inquiry as approved. This records your final decision on the Persona inquiry — useful for dashboard reporting and Persona's feedback loop. Does NOT itself gate the user; you must still enforce the decision in your app.
READdecline_inquiry
Mark an inquiry as declined. Records your final reject decision on the Persona inquiry for reporting and feedback.
READredact_inquiry
Redact an inquiry (GDPR right-to-erasure). Scrubs PII, captured images, and verification detail for this inquiry on Persona's side. Irreversible.
WRITEcreate_account
Create a persistent Persona account — a long-lived end-user record that multiple inquiries can attach to. Enables re-use of previously verified fields and longitudinal fraud signals across sessions.
READretrieve_account
Retrieve a Persona account by id, including summary PII and linked inquiries / verifications.

Frameworks compatibles

MCP es un protocolo — cualquier framework que lo hable puede montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Cualquier cliente MCPProtocolo

Preguntas frecuentes

Corré `npx -y @codespar/mcp-persona` y agregá el bloque de config de arriba a tu cliente MCP — Claude, Cursor, VS Code o cualquier cliente compatible con MCP. Sin build, sin SDK. ¿Preferís hosted? El tier gestionado de CodeSpar lo corre por vos, con la auth resuelta.
Persona — MCP server · 20 tools | CodeSpar