Mcp Persona

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

MCP server for Persona — developer-first identity verification + KYC (inquiries, accounts, reports)

已验证STDIO仅桌面安全与监控商业与电商

概览

AI 生成的概览

面向 Persona 身份验证与 KYC 的本地 MCP 服务器，让助手创建和管理 inquiry、账户、报告与案件。

可以做什么
  • 创建、查询、列出、批准、拒绝、抹除与恢复验证 inquiry
  • 创建、更新、列出和查询长期保存的终端用户账户
  • 运行独立报告，并列出或查询报告详情
  • 创建、列出和查询调查案件，并为案件添加标签
  • 列出 inquiry 模板与 webhook 订阅
适用场景
适合在 Persona 上搭建身份验证或 KYC 流程的团队，让助手在编辑器或对话中直接处理 inquiry、账户、报告和人工审核案件，而不必打开后台面板。
运行要求
通过 npm 包以 npx 在本地运行，需要 Node.js。需要 Persona API 密钥，放在 PERSONA_API_KEY 中，以 bearer 令牌发送；PERSONA_API_VERSION 可选，用于固定 API 版本。需要能访问 Persona 的 API。
安装前请注意
该 API 密钥可访问身份验证数据，请勿写入共享配置。工具会读取并返回姓名、出生日期、地址、报告详情等个人数据，并可批准、拒绝、抹除或更新记录，从而改变真实的验证结果。抹除操作不可撤销，通常对应数据删除请求。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Persona，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-persona

MCP server for Persona — modern developer-first identity verification and KYC.

Persona is the programmable identity layer favoured by modern startups and fintechs that prioritise DX and template-driven workflows. Instead of a fixed KYC pipeline, you compose inquiry templates in the Persona dashboard that reuse building blocks — document, selfie, database, phone, bank — and Persona orchestrates the hosted flow.

Fourth entry in CodeSpar's identity category. Where it fits alongside the others:

ProviderPositioning
UnicoBR leader — local PEP, court records, Receita Federal biometric pool
OnfidoGlobal challenger — document + facial similarity across 195+ countries
JumioGlobal enterprise — deeper fraud intelligence, longer operator track record
PersonaModern developer-first — great DX, template-driven programmable workflows

Pick Persona when you want to ship fast, iterate on the flow without a vendor ticket, and wire verification into your own product surfaces.

Tools (20)

ToolPurpose
create_inquiryCreate a Persona inquiry — a verification session bound to an inquiry template you configured in the Person...
retrieve_inquiryRetrieve an inquiry by id.
list_inquiriesList inquiries, filterable by reference-id (your internal user id) or status.
approve_inquiryMark an inquiry as approved.
decline_inquiryMark an inquiry as declined.
redact_inquiryRedact an inquiry (GDPR right-to-erasure).
create_accountCreate a persistent Persona account — a long-lived end-user record that multiple inquiries can attach to.
retrieve_accountRetrieve a Persona account by id, including summary PII and linked inquiries / verifications.
list_reportsList reports — individual verification artifacts (e.g.
retrieve_reportRetrieve a single report by id — returns the full verification detail (matches, scores, raw source data).
create_caseOpen a case — a workspace for an ongoing investigation tied to one or more inquiries / accounts.
resume_inquiryResume a paused inquiry — returns a fresh one-time session token / link so the end user can continue a flow...
update_accountPatch attributes on an existing Persona account (e.g.
list_accountsList Persona accounts, filterable by reference-id (your internal user id) or email.
run_reportCreate and run a standalone Persona report — not tied to an inquiry flow.
retrieve_caseRetrieve a case by id — full detail including status, assignee, linked objects, attached fields, and tags.
list_casesList investigation cases, filterable by status, assignee, or priority.
add_case_tagAdd a tag to a case.
list_templatesList inquiry templates configured in your Persona dashboard — returns each template's id (itmpl_...), name,...
list_webhooksList configured webhook subscriptions (Persona calls them 'Webhook subscriptions').

Flow

create_inquiry (inquiry-template-id=itmpl_...)    -> user completes Persona-hosted flow (doc + selfie + whatever the template runs)    -> retrieve_inquiry   (poll until status = 'completed' | 'approved' | 'declined' | 'needs_review')    -> approve_inquiry / decline_inquiry   (record your final decision)    -> list_reports / retrieve_report       (for standalone reports like watchlist / adverse-media)

Accounts (create_account / retrieve_account) persist end-user records across inquiries — attach future sessions via account-id on create_inquiry.

Cases (create_case) open a workspace for ongoing investigations (periodic re-verification, flagged users, manual review).

Install

bash
npm install @codespar/mcp-persona

Environment

bash
PERSONA_API_KEY="..."              # API key (required, secret)PERSONA_API_VERSION="2023-01-05"   # Optional. Sent as Persona-Version header.

Authentication

Authorization: Bearer <PERSONA_API_KEY>Persona-Version: 2023-01-05

The server handles both headers automatically.

JSON:API envelope

Persona uses a JSON:API-style request envelope: every POST body is wrapped as { data: { attributes: {...} } }. This server handles the wrapping for you — tool inputs mirror the inner attributes shape directly, with kebab-case keys per Persona's convention:

json
{  "inquiry-template-id": "itmpl_ABC123",  "reference-id": "user_42",  "fields": {    "name-first": "Ada",    "name-last": "Lovelace",    "birthdate": "1815-12-10",    "address-country-code": "US"  }}

The server sends it on the wire as:

json
{ "data": { "attributes": { "inquiry-template-id": "itmpl_ABC123", ... } } }

Run

bash
# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-persona
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-persona

When to pick Persona vs other identity providers

SignalPick
Fast-moving startup / fintech, DX matters, want to iterate on flowPersona
Need custom workflow reusing doc + selfie + bank + phone verificationsPersona
User is Brazilian, need CPF + Receita Federal biometric matchUnico
Global coverage across 195+ countries, regulated fintech AML/PEPOnfido
Bank / large regulated marketplace needing deep fraud intelligenceJumio

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

来源：packages/identity/persona/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分