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 分