mcp-persona — Persona MCP server for Claude Code
Connect Claude Code to Persona to manage identity checks, accounts, reports, and investigations. Useful when verification flows are built from Persona templates.
claude mcp add --env PERSONA_API_KEY=<PERSONA_API_KEY> --env PERSONA_API_VERSION=<PERSONA_API_VERSION> --transport stdio persona -- npx -y @codespar/mcp-personaWhat mcp-persona does
The server gives an agent tools to create and look up identity inquiries, manage accounts and investigation cases, and retrieve reports. An inquiry uses a template configured in Persona: the end user completes Persona’s hosted flow, then the agent can check its status and record a decision. Accounts keep user records across inquiries, and cases group work on investigations.
There are 20 tools. The server builds Persona’s JSON:API request envelope, so tool parameters can use the inner attributes directly. A secret PERSONA_API_KEY is required; without it, the server cannot call Persona. PERSONA_API_VERSION is optional. Install the package with npx and register the server in Claude Code.
What it helps with
- start an identity check from a Persona template
- find inquiries by status or internal user ID
- resume a paused verification flow
- keep a user account linked across inquiries
- open an investigation case and retrieve its reports
Example prompts for the agent
- Create a Persona inquiry from template
itmpl_ABC123for useruser_42. - Find Persona inquiries for user
user_42and show their statuses. - Open an investigation case for this inquiry and retrieve its report.
How to install mcp-persona
Platform CLI
claude mcp add --env PERSONA_API_KEY=<PERSONA_API_KEY> --env PERSONA_API_VERSION=<PERSONA_API_VERSION> --transport stdio persona -- npx -y @codespar/mcp-personaReplace <…> with your own values
Platform CLI
codex mcp add persona --env PERSONA_API_KEY=<PERSONA_API_KEY> --env PERSONA_API_VERSION=<PERSONA_API_VERSION> -- npx -y @codespar/mcp-personaReplace <…> with your own values
Config file
{
"mcpServers": {
"persona": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-persona"
],
"env": {
"PERSONA_API_KEY": "<PERSONA_API_KEY>",
"PERSONA_API_VERSION": "<PERSONA_API_VERSION>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"persona": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-persona"
],
"env": {
"PERSONA_API_KEY": "<PERSONA_API_KEY>",
"PERSONA_API_VERSION": "<PERSONA_API_VERSION>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PERSONA_API_KEY=<PERSONA_API_KEY> -e PERSONA_API_VERSION=<PERSONA_API_VERSION> persona npx -y @codespar/mcp-personaReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-persona
How do I install mcp-persona in Claude Code?
Run claude mcp add mcp-persona -e PERSONA_API_KEY=<PERSONA_API_KEY> -- npx -y @codespar/mcp-persona. Replace the placeholder with your Persona API key.
What does mcp-persona do?
It connects an agent to Persona and exposes tools for identity inquiries, accounts, reports, and investigation cases. Inquiries run from templates configured in Persona.
How does mcp-persona handle Persona's JSON:API format?
The server wraps request attributes in the required JSON:API structure. Set PERSONA_API_KEY to connect; PERSONA_API_VERSION can also be supplied.
