Connect Persona to AI agents

Connect Persona to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

create_inquiry

Create Inquiry

Create a new identity verification inquiry from a template. The inquiry can be pre-populated with user data and later completed by the end-user via hosted flow, embedded flow, or mobile SDK. Returns the inquiry ID and a session token for embedding the flow.

get_verification

Get Verification

Retrieve the full details and check results of a specific verification. Supports all verification types: Government ID, Selfie, Document, and Database.

get_event

Get Event

Retrieve the full details of a specific event, including the complete payload with all affected resource data.

get_report

Get Report

Retrieve the details of a specific report including its status, matches, and findings.

create_case

Create Case

Create a new manual review case. Cases support human review workflows for flagged inquiries, verifications, or other events requiring manual judgment.

create_account

Create Account

Create a new Persona account representing a unique individual. Accounts consolidate all inquiries, verifications, and reports for a person.

get_transaction

Get Transaction

Retrieve the details of a specific transaction including its status, associated verifications, and reports.

list_inquiries

List Inquiries

List inquiries with optional filters for status, reference ID, and account. Supports cursor-based pagination.

get_inquiry

Get Inquiry

Retrieve the details of a specific inquiry including its status, verification results, and associated account information.

list_cases

List Cases

List manual review cases with optional status filter. Supports cursor-based pagination.

redact_verification

Redact Verification

Permanently delete all PII from a verification. **This action cannot be undone.** Use for GDPR/CCPA compliance.

list_events

List Events

List recent events in your Persona organization. Events represent actions like inquiry completions, verification results, report findings, and account changes. Events are retained for up to 90 days.

redact_account

Redact Account

Permanently delete all PII from an account and its associated resources. **This action cannot be undone.** Use for GDPR/CCPA compliance.

create_report

Create Report

Create a new background check or risk intelligence report. Supports all report types: Address Lookup, Adverse Media, Business Adverse Media, Watchlist, Business Watchlist, PEP, Email Address, Phone Number, and Profile. Provide the report template ID and relevant attributes for the report type.

get_account

Get Account

Retrieve the details of a specific Persona account, including its associated inquiries, verifications, and reports.

decline_inquiry

Decline Inquiry

Decline a completed inquiry, marking the individual's identity as not verified. Optionally include a reviewer comment.

tag_transaction

Tag Transaction

Add or remove tags on a transaction to organize and categorize them.

consolidate_accounts

Consolidate Accounts

Merge multiple accounts into a primary account. All inquiries, verifications, and reports from the secondary accounts will be moved to the primary account.

tag_inquiry

Tag Inquiry

Add or remove tags on an inquiry, or replace all tags. Use tags to organize and categorize inquiries.

get_list_items

Get List Items

Retrieve items from a specific screening list. Items represent individual identifiers (emails, phone numbers, government IDs, etc.) contained in the list.

list_transactions

List Transactions

List transactions with optional filters. Supports cursor-based pagination.

create_list_item

Create List Item

Add a new item to a screening list. The item type and required attributes depend on the list type (email, phone, government ID, name, etc.).

update_account

Update Account

Update an account's attributes such as name, email, phone, or reference ID.

list_lists

List Lists

Retrieve all screening lists (blocklists, allowlists) in your Persona organization. Lists contain sets of identifiers used for screening purposes.

approve_inquiry

Approve Inquiry

Approve a completed inquiry, marking the individual's identity as verified. Optionally include a reviewer comment.

create_transaction

Create Transaction

Create a new transaction for API-driven identity verification. Transactions are the primary mechanism for triggering verifications and reports through Workflows without front-end user interaction.

get_case

Get Case

Retrieve the details of a specific manual review case.

list_verifications

List Verifications

List verifications with optional filters for inquiry ID and status. Supports cursor-based pagination.

redact_inquiry

Redact Inquiry

Permanently delete all PII associated with an inquiry. **This action cannot be undone.** Use for GDPR/CCPA compliance.

archive_list_item

Archive List Item

Archive (soft-delete) an item from a screening list. The item will no longer be active for screening purposes.

resume_inquiry

Resume Inquiry

Resume an expired or in-progress inquiry. Returns a new session token that can be used to re-embed the inquiry flow for the end-user.

update_case

Update Case

Update a case's status, assignment, or tags. Supports setting status, assigning a reviewer, and managing tags in a single operation.

tag_account

Tag Account

Add or remove tags on an account, or replace all tags. Tags help organize accounts for screening and workflow purposes.

list_reports

List Reports

List reports with optional filters. Supports cursor-based pagination.

generate_inquiry_link

Generate Inquiry Link

Generate a one-time link for an inquiry that can be shared with the end-user to complete their verification.

list_accounts

List Accounts

List Persona accounts with optional filters. Supports cursor-based pagination.

More integrations teams use with Persona

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues. Subscribe to real-time webhooks for changes to issues, projects, cycles, comments, documents, and more.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Track issues with the built-in issue tracker. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

GitLab

Manage GitLab projects, repositories, issues, merge requests, releases, and CI/CD workflows from one provider. Includes pipeline, job, variable, environment, schedule, trigger, runner, deployment, CI lint, and test report tools.

Technical notes for Persona

Verify identities and manage compliance workflows for individuals and businesses. Create and manage inquiries for end-to-end identity verification flows using government IDs, selfies, and documents. Run database verifications, generate risk reports (watchlist, adverse media, PEP, address, email, phone), and screen against sanctions lists. Manage accounts representing verified individuals, consolidate or redact personal data for GDPR/CCPA compliance. Create and manage cases for manual review workflows. Maintain screening lists (blocklists/allowlists) with custom list items. Trigger automated workflows based on verification results. Analyze relationships between accounts via graph connections. Monitor events via webhooks for inquiries, verifications, reports, transactions, and cases.

Connect Persona to production AI agents

See how Metorial gives Persona access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Persona to AI agents with Metorial.

  1. Can Metorial connect Persona to AI agents?
    Yes. Metorial connects AI agents to Persona through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.