Skip to main content
P

Persona

@codespar/mcp-persona · v0.2.2

🌐 GlobalIdentidade e KYCAuth · API Keybeta20 ferramentas2 variáveis de ambiente

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

Comece · grátisVer docs

MIT · roda localmente com as suas credenciais

Variáveis de ambiente, nomes e descrições das ferramentas vêm do pacote npm e ficam em inglês.

Limitações

  • Chamadas hospedadas com chave de teste não estão disponíveis: o runtime não registrou o comportamento deste provedor em teste (test venue unclassified).
Pacote
@codespar/mcp-persona
Versão
0.2.2
dist-tag npm
latest
Categoria
Identidade e KYC
Auth
API Key
País
🌐 Global
Licença
MIT
Transporte
stdio · streamable-http

Início rápido

Instale, configure as credenciais, faça a primeira chamada.

Escolha seu cliente. O servidor roda localmente via stdio, com as suas credenciais.

Adicione o servidor ao seu clienteUma entrada de configuração. Sem build, sem SDK.
Defina as variáveis de ambiente2 variáveis lidas pelo código deste servidor, listadas abaixo.
Reinicie e faça a primeira chamadaO agente pode chamar qualquer uma das 20 ferramentas. Comece por create_inquiry.
terminal
# Claude Code claude mcp add persona -e PERSONA_API_KEY=… -e PERSONA_API_VERSION=… -- npx -y @codespar/mcp-persona@0.2.2 # then: /mcp to confirm the server is connected
Variáveis de ambiente2 variáveis
PERSONA_API_KEYPersona API key. Sent as 'Authorization: Bearer <value>'.obrigatóriasegredo
PERSONA_API_VERSIONPersona API version pin (sent as 'Persona-Version' header). Defaults to '2023-01-05'.opcional

Nomes lidos do código do pacote (@codespar/mcp-persona@0.2.2). Descrições e marcações vêm do manifesto dele. Auto-hospedado, você guarda as credenciais.

Primeira chamada democreate_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"

tools/callcreate_inquiryresultado devolvido

Ferramentas

O que o seu agente pode chamar.

20 ferramentas, como o tools/list do pacote as devolve.

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

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

list_inquiries

List inquiries, filterable by reference-id (your internal user id) or status. Useful for reconciling state or finding a user's inquiry history.

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

decline_inquiry

Mark an inquiry as declined. Records your final reject decision on the Persona inquiry for reporting and feedback.

redact_inquiry

Redact an inquiry (GDPR right-to-erasure). Scrubs PII, captured images, and verification detail for this inquiry on Persona's side. Irreversible.

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

retrieve_account

Retrieve a Persona account by id, including summary PII and linked inquiries / verifications.

list_reports

List reports — individual verification artifacts (e.g. watchlist, adverse media, business lookup). Filterable by account and type. Each report is a standalone verification separate from inquiry-flow verifications.

retrieve_report

Retrieve a single report by id — returns the full verification detail (matches, scores, raw source data).

create_case

Open a case — a workspace for an ongoing investigation tied to one or more inquiries / accounts. Useful for manual review, periodic re-verification, or flagged users that need operator follow-up.

resume_inquiry

Resume a paused inquiry — returns a fresh one-time session token / link so the end user can continue a flow that was abandoned or needs additional steps (e.g. after a 'pending' webhook).

Nomes e descrições vêm do tools/list do pacote (@codespar/mcp-persona@0.2.2). Um tipo (leitura, escrita, exclusão) só aparece quando o pacote anota suas ferramentas ou cada ferramenta foi verificada uma a uma; nenhum dos dois existe ainda para este servidor.

Compatibilidade

MCP é um protocolo. Qualquer cliente que o fale pode montar este servidor.

O codespar_discover lista as ferramentas deste servidor, mas um projeto com chave de teste ainda não consegue chamá-las: o runtime não registrou o que este provedor faz em modo de teste e recusa em vez de adivinhar.

Protocolo

Qualquer cliente MCP

stdio · streamable-http

Perguntas

Antes de instalar.

Como instalo o servidor MCP Persona?

Rode npx -y @codespar/mcp-persona@0.2.2 e adicione o bloco de configuração acima ao seu cliente MCP: Claude Code, Cursor, Claude Desktop, VS Code ou qualquer cliente compatível. Sem build, sem SDK.

O que meu agente pode fazer com Persona?

Persona expõe 20 ferramentas de identidade e kyc. Seu agente as chama diretamente; a lista completa está acima.

Como Persona autentica, e como as credenciais são guardadas?

Persona usa API Key. Auto-hospedado, você guarda as credenciais: o servidor as lê das variáveis de ambiente.

Como Persona lida com mudanças na API do provedor?

Cada servidor tem versão própria no npm. O comando desta página fixa a 0.2.2, a versão cujas ferramentas estão listadas aqui; seu agente segue nela até você trocar a versão.

Persona é open source? Como reporto um bug?

Sim. Persona tem licença MIT e está publicado no npm como @codespar/mcp-persona, com o código no GitHub (link no painel Detalhes). Reporte problemas no repositório do pacote; problemas de segurança vão para security@codespar.dev, e respondemos em até 24 horas.

Combina com

Identidade e KYC · mesma categoria.

U

Unico

@codespar/mcp-unico · 18 ferramentas

Líder brasileira em verificação de identidade / KYC. IDCloud (CPF/CNPJ + OCR de documento), IDPay (face match, liveness), IDCheck (PEP, sanções, registros judiciais). Primeira entrada na categoria Identidade e KYC. Alpha no npm — devcenter.unico.io é fechado por contrato; base URLs sobrescrevíveis via env.

Abrir
O

Onfido

@codespar/mcp-onfido · 20 ferramentas

Líder global em KYC (da Entrust). Applicants, upload de documento, fotos ao vivo, checks (documento + facial + watchlist + known-faces), relatórios. Combina com a Unico (BR-first) pra cobertura global quando o comércio toca usuários fora da LatAm.

Abrir
J

Jumio

@codespar/mcp-jumio · 20 ferramentas

Tier enterprise de KYC global — inteligência de fraude mais profunda, histórico de operação mais longo. Alvo: bancos, grandes fintechs, comércio regulado. Hosts regionais (amer-1 / emea-1 / apac-1). Verificado contra docs.jumio.ai.

Abrir

Comece em segundos.

Adicione a configuração acima, defina as variáveis, e seu agente chama as ferramentas.

Comece em segundos demo
Adicione o servidor ao seu cliente com a configuração acima.
Defina as variáveis de ambiente listadas acima.
Peça ao seu agente a primeira chamada.
Persona — MCP server · 20 tools | CodeSpar