Persona

What your agent can do

Persona gives your agent 20 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →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.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_inquiry", { /* ... */ });

Install

$ npm install @codespar/mcp-persona

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "persona": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-persona"
      ],
      "env": {
        "PERSONA_API_KEY": "<your_persona_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try create_inquiry first.

Environment variables · 2

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions