Persona MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Persona MCP or direct API to verify user identities, manage KYC flows, review verification results, and trigger compliance actions through natural language.

Persona logoPersona
Api Key

Persona offers identity infrastructure to automate user verification and compliance. It helps organizations securely verify users and reduce fraud risk.

69 Tools

Try Persona now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Persona
Try asking
TOOLS

Supported Tools

Every Persona action and event your agent gets out of the box.

Add Tag to Account

Tool to add a tag to an Account in Persona.

Archive Browser Fingerprint List Item

Tool to archive a browser fingerprint list item in Persona.

Archive Country List Item

Tool to archive a Country List Item by ID.

Archive a Geolocation List Item

Tool to archive a geolocation list item from Persona.

Archive Government ID Number List Item

Tool to archive a Government ID Number List Item.

Archive a Name List Item

Tool to archive a name list item in Persona.

Archive a webhook

Tool to archive a Persona webhook by its ID.

Archive Email Address List Item

Tool to archive an Email Address List Item in Persona.

Archive IP Address List Item

Tool to archive an IP address list item in Persona.

Archive Phone Number List Item

Tool to archive a phone number list item in Persona.

Archive String List Item

Tool to archive a String List Item in Persona.

Clone Webhook

Tool to clone an existing Persona webhook.

Consolidate Accounts

Tool to consolidate multiple source accounts into a single destination account.

Create an Account

Tool to create an account in Persona.

Create IP Address List Item

Tool to create an IP Address List Item in Persona.

Create Country List Item

Tool to create a country list item in Persona.

Create Generic Document

Tool to create a generic document in Persona.

Create Email Address List Item

Tool to create an email address list item in Persona.

Create Government ID Number List Item

Tool to create a new government ID number list item in Persona.

Create Name List Item

Tool to create a new name list item in Persona.

Create Phone Number List Item

Tool to create a phone number list item in Persona.

Create String List Item

Tool to create a String List Item in Persona.

Create Webhook

Tool to create a new webhook in Persona.

Disable Webhook

Tool to disable a webhook in Persona.

Enable Webhook

Tool to enable a webhook in Persona.

Expire Inquiry Sessions

Tool to expire all inquiry sessions for specified inquiry IDs.

Import Email Address Lists

Tool to import email addresses into a list from a CSV file.

Import IP Address Lists

Tool to import IP address lists into Persona.

Import Name Lists

Tool to import name lists to Persona.

Import Phone Number Lists

Tool to import phone number lists into Persona.

List All Accounts

Tool to list all accounts in Persona.

List All API Logs

Tool to list all API logs in Persona.

List All Cases

Tool to list all cases in Persona.

List All Devices

Tool to list all devices filtered by inquiry session ID.

List all Events

Tool to list all events from Persona.

List all Importers

Tool to list all importers in Persona.

List All Inquiries

Tool to list all inquiries in Persona.

List All Inquiry Sessions

Tool to list all inquiry sessions in Persona.

List All Lists

Tool to list all lists in Persona.

List All Rate Limits

Tool to list all rate limits in Persona.

List All Reports

Tool to list all reports in Persona.

List All Transactions

Tool to list all transactions in Persona.

List All Webhooks

Tool to list all webhooks in Persona.

List all Workflow Runs

Tool to list all workflow runs in Persona.

Redact an Account

Tool to permanently redact an account in Persona.

Remove Account Tag

Tool to remove a tag from a Persona Account.

Retrieve a Country List Item

Tool to retrieve a country list item by ID in Persona.

Retrieve a Geolocation List Item

Tool to retrieve a geolocation list item from Persona.

Retrieve an Account

Tool to retrieve an account in Persona.

Retrieve a Name List Item

Tool to retrieve a Name List Item in Persona.

Retrieve an Event

Tool to retrieve an event in Persona.

Retrieve an Importer

Tool to retrieve a specific importer in Persona.

Retrieve IP Address List Item

Tool to retrieve an IP Address List Item in Persona.

Retrieve an API Log

Tool to retrieve an API log in Persona.

Retrieve a String List Item

Tool to retrieve a string list item by ID in Persona.

Retrieve a Webhook

Tool to retrieve a webhook by its ID.

Retrieve Browser Fingerprint List Item

Tool to retrieve a browser fingerprint list item in Persona.

Retrieve a Document

Tool to retrieve a document from Persona.

Retrieve Generic Document

Tool to retrieve a generic document in Persona.

Retrieve Email Address List Item

Tool to retrieve an Email Address List Item in Persona.

Retrieve Government ID Number List Item

Tool to retrieve a Government ID Number List Item in Persona.

Retrieve Phone Number List Item

Tool to retrieve a phone number list item in Persona.

Rotate Webhook Secret

Tool to rotate a webhook's secret in Persona.

Search Accounts

Tool to search accounts in Persona using flexible query criteria.

Search Cases

Tool to search cases in Persona using advanced query filters with boolean logic.

Set Tags on Account

Tool to set tags on a Persona Account.

Update an Account

Tool to update an account in Persona.

Update a Webhook

Tool to update a webhook in Persona.

Update Generic Document

Tool to update a generic document in Persona.

SETUP GUIDE

Connect Persona MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Persona
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List all users who passed KYC verification in the last week.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Persona API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Persona Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Get all pending verification cases from Persona.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Persona actions with your Agent

Why Use Composio?

AI Native Persona Integration

  • Supports both Persona MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Persona data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Persona access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Persona
  • Scoped, least privilege access to Persona resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Persona requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Persona.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Persona tool your agent needs.Free to start.

Start building