Skip to main content
PE

Persona

v0.2.1API Key

KYC moderno developer-first — ótima DX e workflows orientados a template. 4ª entrada de identidade (Unico BR / Onfido global / Jumio enterprise / Persona moderno).

20 ferramentas2 env vars🌐 GLOBALestável no npm

O que seu agente faz

O Persona dá ao seu agente 20 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer 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.
Exemplo de chamada
// 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

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).

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

Depois de reiniciar, seu agente pode chamar qualquer uma das 20 ferramentas abaixo — teste create_inquiry primeiro.

Variáveis de ambiente · 2

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

PERSONA_API_KEY
obrigatóriosecret

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

Ferramentas disponíveis · 20

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

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 compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

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

Perguntas frequentes

Rode `npx -y @codespar/mcp-persona` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
Persona — MCP server · 20 tools | CodeSpar