Skip to main content
P

Persona

@codespar/mcp-persona Β· v0.2.2

🌐 GlobalIdentity & KYCAuth · API Keybeta20 tools2 env vars

Modern developer-first KYC β€” great DX and template-driven workflows. 4th identity entry (Unico BR / Onfido global / Jumio enterprise / Persona modern).

Get started Β· freeView docs

MIT Β· runs locally with your own credentials

Limitations

  • Hosted calls with a test key are not available: the runtime has not recorded this provider's test behaviour (test venue unclassified).
Package
@codespar/mcp-persona
Version
0.2.2
npm dist-tag
latest
Category
Identity & KYC
Auth
API Key
Country
🌐 Global
License
MIT
Transport
stdio Β· streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables2 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 20 tools. Try create_inquiry first.
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
Environment variables2 variables
PERSONA_API_KEYPersona API key. Sent as 'Authorization: Bearer <value>'.requiredsecret
PERSONA_API_VERSIONPersona API version pin (sent as 'Persona-Version' header). Defaults to '2023-01-05'.optional

Names read from the package code (@codespar/mcp-persona@0.2.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call 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_inquiryresult returned

Tools

What your agent can call.

20 tools, as the package's tools/list returns them.

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

Names and descriptions come from the package's tools/list (@codespar/mcp-persona@0.2.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but a project with a test key cannot call them yet: the runtime has not recorded what this provider does in test mode, and refuses rather than guess.

Protocol

Any MCP client

stdio Β· streamable-http

Questions

Before you install.

How do I install the Persona MCP server?

Run npx -y @codespar/mcp-persona@0.2.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Persona?

Persona exposes 20 tools for identity & kyc. Your agent calls them directly; the full list is above.

How does Persona authenticate, and how are credentials stored?

Persona uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Persona handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Persona open source? How do I report a bug?

Yes. Persona is MIT-licensed and published on npm as @codespar/mcp-persona, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Pairs well with

Identity & KYC Β· same category.

U

Unico

@codespar/mcp-unico Β· 18 tools

Brazilian identity verification / KYC leader. IDCloud (CPF/CNPJ + document OCR), IDPay (face match, liveness), IDCheck (PEP, sanctions, court records). First entry in the Identity & KYC category. Alpha on npm β€” devcenter.unico.io is contract-gated; base URLs overridable via env.

Open
O

Onfido

@codespar/mcp-onfido Β· 20 tools

Global KYC leader (Entrust-owned). Applicants, document upload, live photos, checks (document + facial + watchlist + known-faces), reports. Pairs with Unico (BR-first) for global coverage when commerce touches non-LatAm users.

Open
J

Jumio

@codespar/mcp-jumio Β· 20 tools

Global KYC enterprise tier β€” deeper fraud intelligence, longer operator history. Target: banks, large fintechs, regulated commerce. Regional hosts (amer-1 / emea-1 / apac-1). Verified against docs.jumio.ai.

Open

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Persona β€” MCP server Β· 20 tools | CodeSpar