Persona
Persona offers identity infrastructure that allows you to craft personalized and automated verification solutions so you can better understand & protect users.
Verdict
Common use cases
- Tag flagged accounts during fraud review
- Archive stale email addresses from blocklists
- Check verification status from support chat
- Audit webhook configurations across environments
- Remove outdated browser fingerprints from lists
Integration
- Vendor
- Persona
- Category
- other
- Auth
- API_KEY
- Tools
- 50
- Composio slug
persona
Tools
- Add Tag to Account
Tool to add a tag to an Account in Persona. Use when you need to categorize or label an account with a specific tag. Either tag_id or tag_name must be provided in the request meta.
- Archive a Geolocation List Item
Tool to archive a geolocation list item from Persona. Use when you need to archive a specific geolocation list item by its ID. This operation marks the item as archived without permanently deleting it.
- Archive a Name List Item
Tool to archive a name list item in Persona. Use when you need to archive a specific name list item by its ID.
- Archive a webhook
Tool to archive a Persona webhook by its ID. Use when you need to deactivate a webhook without deleting it. Archived webhooks will no longer receive events but can be referenced for historical purposes.
- Archive Browser Fingerprint List Item
Tool to archive a browser fingerprint list item in Persona. Use when you need to mark a browser fingerprint list item as archived without permanently deleting it.
- Archive Country List Item
Tool to archive a Country List Item by ID. Use when you need to mark a country list item as archived. This action is idempotent - archiving an already archived item is safe.
- Archive Email Address List Item
Tool to archive an Email Address List Item in Persona. Use when you need to archive an email address or domain from a list. The archived item will be marked with an archived timestamp in the response.
- Archive Government ID Number List Item
Tool to archive a Government ID Number List Item. Use when you need to remove a government ID number from the active list.
- Archive IP Address List Item
Tool to archive an IP address list item in Persona. Use when you need to remove an IP address from active monitoring.
- Archive Phone Number List Item
Tool to archive a phone number list item in Persona. Use when you need to mark a phone number list item as archived without permanently deleting it.
- Archive String List Item
Tool to archive a String List Item in Persona. Use when you need to mark a string list item as archived without permanently deleting it. The item will be marked with an archived timestamp and its status will be updated accordingly.
- Clone Webhook
Tool to clone an existing Persona webhook. Use when you need to duplicate a webhook configuration with all its settings.
- Consolidate Accounts
Tool to consolidate multiple source accounts into a single destination account. Use when merging duplicate accounts or combining account data from multiple sources into one primary account.
- Create an Account
Tool to create an account in Persona. Use when you need to create a new account with personal information such as name, email, phone, address, and custom fields.
- Create Country List Item
Tool to create a country list item in Persona. Use when you need to add a country to a country list for identity verification or compliance purposes.
- Create Email Address List Item
Tool to create an email address list item in Persona. Use when you need to add an email address to a watchlist or blocklist.
- Create Generic Document
Tool to create a generic document in Persona. Use when you need to create a document record of a specific kind/type for an account or inquiry.
- Create Government ID Number List Item
Tool to create a new government ID number list item in Persona. Use when you need to add a government ID number (such as SSN, passport, or driver's license) to a watchlist or monitoring list.
- Create IP Address List Item
Tool to create an IP Address List Item in Persona. Use when you need to add an IP address to a watchlist or allowlist for identity verification purposes. The list ID must be obtained first using a list retrieval action.
- Create Name List Item
Tool to create a new name list item in Persona. Use when you need to add a person's name to a specific list for verification or monitoring purposes.
- Create Phone Number List Item
Tool to create a phone number list item in Persona. Use when you need to add a phone number to a specific list for tracking or verification purposes.
- Create String List Item
Tool to create a String List Item in Persona. Use when adding a new string value to an existing list for matching or filtering purposes.
- Create Webhook
Tool to create a new webhook in Persona. Use when you need to set up real-time notifications for specific events in your Persona account. The webhook will send POST requests to your URL when enabled events occur.
- Disable Webhook
Tool to disable a webhook in Persona. Use when you need to stop a webhook from receiving events without deleting it.
- Enable Webhook
Tool to enable a webhook in Persona. Use when you need to activate a previously disabled webhook.
- Expire Inquiry Sessions
Tool to expire all inquiry sessions for specified inquiry IDs. Use when you need to expire multiple inquiry sessions at once by providing a list of inquiry IDs.
- Import Email Address Lists
Tool to import email addresses into a list from a CSV file. Use when you need to bulk import email addresses for identity verification or list management.
- Import IP Address Lists
Tool to import IP address lists into Persona. Use when you need to bulk upload IPv4 or IPv6 addresses to an existing list.
- Import Name Lists
Tool to import name lists to Persona. Use when you need to bulk import first and last names to an existing name list for identity verification purposes.
- Import Phone Number Lists
Tool to import phone number lists into Persona. Use when you need to bulk upload phone numbers in E.164 format to an existing list.
- List All Accounts
Tool to list all accounts in Persona. Use when you need to retrieve a paginated list of accounts with optional filtering by reference ID or account type.
- List All API Logs
Tool to list all API logs in Persona. Use when you need to retrieve a paginated history of API requests made to your organization, including request details, response status, and timing information.
- List All Cases
Tool to list all cases in Persona. Use when you need to retrieve a collection of cases with optional filtering and pagination.
- List All Devices
Tool to list all devices filtered by inquiry session ID. Use when you need to retrieve devices associated with a specific inquiry session.
- List all Events
Tool to list all events from Persona. Use when you need to retrieve events for your organization. Supports pagination and filtering by creation date. Events up to 3 months old can be viewed.
- List all Importers
Tool to list all importers in Persona. Use when you need to retrieve a list of all import operations, including account importers, email address list importers, and other types.
- List All Inquiries
Tool to list all inquiries in Persona. Use when you need to retrieve a paginated collection of inquiries with optional filtering by reference ID, account ID, status, or inquiry template ID.
- List All Inquiry Sessions
Tool to list all inquiry sessions in Persona. Use when you need to retrieve a collection of inquiry sessions with optional filtering.
- List All Lists
Tool to list all lists in Persona. Use when you need to retrieve a paginated collection of lists with optional filtering and field selection.
- List All Rate Limits
Tool to list all rate limits in Persona. Use when you need to retrieve current rate limit information for your API usage.
- List All Reports
Tool to list all reports in Persona. Use when you need to retrieve a collection of reports with optional filtering and pagination. Reports can include various types such as adverse media, watchlist, profile, and verification reports.
- List All Transactions
Tool to list all transactions in Persona. Use when you need to retrieve a paginated collection of transactions with optional filtering.
- List All Webhooks
Tool to list all webhooks in Persona. Use when you need to retrieve a paginated list of webhooks configured for the account.
- List all Workflow Runs
Tool to list all workflow runs in Persona. Use when you need to retrieve workflow runs with optional filtering by workflow ID, inquiry ID, account ID, or session token. Supports pagination for large result sets.
- Redact an Account
Tool to permanently redact an account in Persona. Use when you need to delete sensitive personal information from an account to comply with privacy regulations or user requests. This operation is irreversible.
- Remove Account Tagdestructive
Tool to remove a tag from a Persona Account. Use when you need to remove a tag association from an account by providing either the tag ID or tag name.
- Retrieve a Country List Item
Tool to retrieve a country list item by ID in Persona. Use when you need to fetch details of a specific country list item.
- Retrieve a Geolocation List Item
Tool to retrieve a geolocation list item from Persona. Use when you need to fetch details of a specific geolocation list item by its ID.
- Retrieve an Account
Tool to retrieve an account in Persona. Use when you need to fetch details of a specific account by its ID.
- Retrieve a Name List Item
Tool to retrieve a Name List Item in Persona. Use when you need to get details about a specific name list item, including first name, last name, status, match count, and timestamps.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the MCP integrations panel. 2. Click 'Add MCP' and select Persona from the catalog. 3. You'll be prompted to enter a Persona API key — generate one in your Persona dashboard under Settings > API Keys, ensuring it has read and write access to accounts, lists, and webhooks. 4. Paste the key into Switchy and click 'Connect'. 5. Switchy will validate the key and display a list of available tools. 6. Open any Space, type '@Persona' in the chat, and choose a tool from the autocomplete menu to test the connection. 7. Try a simple command like '@Persona list recent accounts' to confirm data flows correctly. 8. If a tool fails, check the API key's scope in Persona — some operations (archiving government ID numbers, managing webhooks) require admin-level permissions.
What teammates see: by default, memories from Persona are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Tag High-Risk Account
@Persona add the tag 'high-risk-manual-review' to account acc_ABC123XYZ. Confirm the tag was applied and show the account's current tag list.Open in a Space →
Archive Blocklist Entry
@Persona archive the email address list item eli_456DEF789. Show the archived timestamp and confirm it's no longer active.Open in a Space →
Check Verification Status
@Persona look up inquiry inq_789GHI012 and tell me its verification status, decision, and any flags. Summarize in two sentences.Open in a Space →
Audit Active Webhooks
@Persona list all active webhooks in my Persona account. For each, show the URL, events it listens to, and when it was last updated.Open in a Space →
Clean Geolocation List
@Persona archive geolocation list item gli_321JKL654. Confirm it's archived and show how many items remain in the list.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Persona show me all accounts tagged 'high-risk' that were created in the last 30 days
Found 14 accounts tagged 'high-risk' created since December 15, 2024. The accounts include: ACC-7f3a (created Dec 18, flagged for multiple address changes), ACC-8b2c (created Dec 22, failed document verification twice), ACC-9d1e (created Dec 28, geolocation mismatch detected), and 11 others. All accounts are currently under review status. Would you like me to pull verification details for any specific account or export this list?
This example demonstrates Persona's account querying and tag filtering capabilities. Requires read:accounts scope. Note that tag-based queries may return large result sets in production environments—consider adding pagination or date filters to keep responses manageable.
@Persona add the tag 'manual-review-required' to account ACC-4k7m and archive the email address john.doe.suspicious@tempmail.com from our blocklist
Completed both actions: (1) Added tag 'manual-review-required' to account ACC-4k7m. The account now has 3 active tags: 'manual-review-required', 'pending-verification', 'new-user'. (2) Archived email address 'john.doe.suspicious@tempmail.com' from Email Address List EML-list-92x. The item was archived at 2025-01-14T18:32:41Z and will no longer block new account creation attempts using this address.
This showcases Persona's write operations for account management and list maintenance. Both actions require write permissions (write:accounts and write:lists). Be aware that archiving list items is immediate and affects ongoing verification flows—confirm the correct item ID before archiving.
@Persona analyze the last 50 failed verifications and tell me which document types are failing most often and why
Analyzed 50 recent failed verifications from the past 7 days. Top failure patterns: (1) Driver's licenses (22 failures, 44%)—primary reason is poor image quality and glare obscuring text. (2) Passports (14 failures, 28%)—mostly expired documents or bio page not fully visible. (3) National IDs (9 failures, 18%)—mix of unsupported issuing countries and damaged documents. Recommendation: Update your verification flow messaging to emphasize lighting conditions for driver's licenses and expiration date checks before upload.
This example pairs Persona's verification data retrieval with AI synthesis to surface actionable insights. Requires read:verifications scope. The analysis quality depends on having sufficient historical data—newer Persona accounts may see less meaningful patterns until verification volume builds up.
Use-case deep-dives
When Persona MCP fits high-volume identity verification teams
A 6-person fraud operations team at a fintech runs 200+ identity verifications daily and maintains blocklists for flagged emails, device fingerprints, and government IDs. The Persona MCP is the right call here because it exposes 50+ tools for programmatic list management—archiving email addresses, tagging accounts, and updating geolocation rules without clicking through the Persona dashboard. If your team processes fewer than 20 verifications a week, the overhead of configuring API key auth and learning the tool names outweighs the benefit; just use the web UI. Above that threshold, the MCP pays off by letting your fraud analyst update blocklists from Slack threads or standup notes without context-switching. Set up the MCP if you're archiving list items or tagging accounts more than twice a day.
How this MCP supports quarterly KYC compliance reviews
A 3-person compliance team at a crypto exchange runs quarterly audits of all customer identity verifications and needs to tag accounts that failed specific checks or archive outdated list entries. The Persona MCP works well for this scenario because it surfaces tools like 'Add Tag to Account' and 'Archive Government ID Number List Item' that let the compliance lead batch-process tagging and archival tasks from a shared workspace. The MCP requires API key auth, so your compliance team needs read-write access to Persona's API—check with your security team before provisioning keys. If your audit cadence is annual or your verification volume is under 100 accounts per quarter, the setup cost isn't worth it; export CSV reports from Persona instead. Use the MCP if you're tagging or archiving more than 50 items per audit cycle.
Why this MCP is overkill for most support ticket workflows
A 4-person customer support team at a lending platform occasionally needs to check if a user's email or government ID is on a blocklist when troubleshooting failed verification tickets. The Persona MCP is probably not the right tool here. While it exposes list-item lookup and archival tools, the 50-tool surface area is designed for fraud ops teams making bulk updates, not support agents answering one-off tickets. Your support team will spend more time learning which tool to invoke than they'd spend logging into Persona's dashboard to run a manual search. The MCP makes sense only if your support volume includes 10+ identity-related tickets per day and you're already using Switchy for ticket triage. Below that threshold, keep identity lookups in the Persona UI and save the MCP setup for teams doing programmatic list management.
Frequently asked
What does the Persona MCP do in Switchy?
The Persona MCP connects Switchy to your Persona identity verification platform. It lets AI assistants manage verification workflows, tag accounts, archive list items (names, emails, geolocation, government IDs), and control webhooks. You can automate compliance tasks, update watchlists, and query verification data without switching to Persona's dashboard. It's built for teams running KYC or fraud prevention workflows who want AI to handle routine identity operations.
Do I need admin access to connect Persona?
You need a Persona API key with write permissions to use this MCP. Persona uses API key authentication, not OAuth, so whoever connects it must generate a key from their Persona account settings. The key inherits the permissions of the user who creates it. If your team restricts API key creation to admins, you'll need admin involvement. Otherwise, any user with API access can connect it.
Can the Persona MCP create new verification inquiries?
The representative tools shown focus on account tagging, list management (archiving names, emails, geolocation, government IDs), and webhook administration. Persona's API supports inquiry creation, but whether this MCP exposes that tool depends on the full 50-tool set. If inquiry creation isn't listed in your Switchy workspace, you'll need to create inquiries through Persona's dashboard or their API directly.
How does this compare to using Persona's API directly?
The MCP wraps Persona's API in natural language. Instead of writing POST requests to archive a list item or add account tags, you ask an AI assistant in plain English. It's faster for ad-hoc operations and teams without developers. You lose fine-grained control over request parameters and can't batch operations as efficiently as raw API calls, but you gain speed and accessibility for non-technical users.
Who on the team should connect the Persona MCP?
Whoever manages your Persona account and has API key creation rights. This is typically a compliance lead, fraud operations manager, or technical admin. Once connected in Switchy, any team member with workspace access can use the MCP through AI assistants. The connector's API key permissions determine what actions are possible, so choose someone whose Persona role matches your team's intended use cases.