Skip to main content

Set up the Persona MCP server

The Persona MCP server lets AI agents query identity verification data — inquiries, verifications, accounts, reports, and transactions — directly from Persona's platform. This guide walks through generating a Persona API key and connecting the pre-listed server to MintMCP.

Prerequisites

Generate a Persona API key

  1. Go to app.withpersona.com/dashboard/api-keys.
Persona Dashboard API Keys page
  1. Click Create new API key.
  2. Enter a name (for example, "MintMCP") and configure permissions for the key.

Persona recommends creating a dedicated key with only the scopes your agents need. The table below maps common capabilities to their required scopes:

CapabilityScopes
Read inquiriesinquiry.read
Read verificationsverification.read
Read reportsreport.read
Read casescase.read
Read accountsaccount.read
Read transactionstxn.read
Create or update inquiriesinquiry.write
Update casescase.write
Trigger workflowsworkflow.trigger
  1. Click Create API key and copy the key value. Persona only shows it once.

Add Persona to MintMCP

  1. In MintMCP, go to MCP store > Manage store.
  2. Click the Recommended Servers tab.
  3. Find Persona and click to configure it.
  4. Set Connection type to Shared credentials.
  5. Set Authorization method to Bearer Token.
  6. Paste the API key into the Bearer Token field.
  7. Click Create.

Security considerations

  • API keys carry access to your Persona identity data within the configured scopes — store them securely and never commit them to source control.
  • Grant only the scopes your agents require. Read-only scopes (*.read) are sufficient for agents that retrieve data without taking actions.
  • Persona's MCP server enforces key-level permissions on every request, so a leaked key exposes only the scopes it was granted.
  • If a key is compromised, rotate it immediately from the Dashboard API keys page.