Read Persona inquiries, accounts, verifications and reports.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
WRITE: adds a tag to an account (mutates state). Tags label/segment accounts for review and automation. Sends JSON body { meta: { "tag-name": <tag_name> } }. Persona REST: POST /accounts/{account_id}/add-tag.
The tag name to add to the account.
The account id to tag (e.g. act_...).
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
WRITE: adds a tag to an account (mutates state). Tags label/segment accounts for review and automation. Sends JSON body { meta: { "tag-name": <tag_name> } }. Persona REST: POST /accounts/{account_id}/add-tag.
| Argument | Type | Description |
|---|---|---|
| tag_name* | string | The tag name to add to the account. |
| account_id* | string | The account id to tag (e.g. act_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_id",
"tag_name"
],
"properties": {
"tag_name": {
"type": "string",
"description": "The tag name to add to the account."
},
"account_id": {
"type": "string",
"description": "The account id to tag (e.g. act_...)."
}
}
}Get a single account by id — the persistent identity record for an end user. Returns JSON:API { data } containing PII. Persona REST: GET /accounts/{account_id}.
| Argument | Type | Description |
|---|---|---|
| account_id* | string | The account id (e.g. act_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_id"
],
"properties": {
"account_id": {
"type": "string",
"description": "The account id (e.g. act_...)."
}
}
}Get a single case by id — a manual-review workflow item. Returns JSON:API { data } containing PII. Persona REST: GET /cases/{case_id}.
| Argument | Type | Description |
|---|---|---|
| case_id* | string | The case id (e.g. case_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"case_id"
],
"properties": {
"case_id": {
"type": "string",
"description": "The case id (e.g. case_...)."
}
}
}Get a single audit-trail event by id, including its name and payload. Returns JSON:API { data } — payloads may reference PII. Persona REST: GET /events/{event_id}.
| Argument | Type | Description |
|---|---|---|
| event_id* | string | The event id (e.g. evt_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"event_id": {
"type": "string",
"description": "The event id (e.g. evt_...)."
}
}
}Get a single identity-verification inquiry by id, including its status, template, and relationships (verifications, account). Returns JSON:API { data } containing PII. Persona REST: GET /inquiries/{inquiry_id}.
| Argument | Type | Description |
|---|---|---|
| inquiry_id* | string | The inquiry id (e.g. inq_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"inquiry_id"
],
"properties": {
"inquiry_id": {
"type": "string",
"description": "The inquiry id (e.g. inq_...)."
}
}
}Get a single report by id — a screening/monitoring result (e.g. watchlist, adverse-media, business lookup). Returns JSON:API { data } containing PII. Persona REST: GET /reports/{report_id}.
| Argument | Type | Description |
|---|---|---|
| report_id* | string | The report id (e.g. report_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"report_id"
],
"properties": {
"report_id": {
"type": "string",
"description": "The report id (e.g. report_...)."
}
}
}Get a single transaction by id — a record submitted for transaction fraud/monitoring analysis. Returns JSON:API { data } containing PII. Persona REST: GET /transactions/{transaction_id}.
| Argument | Type | Description |
|---|---|---|
| transaction_id* | string | The transaction id (e.g. txn_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transaction_id"
],
"properties": {
"transaction_id": {
"type": "string",
"description": "The transaction id (e.g. txn_...)."
}
}
}Get a single verification by id — one identity check within an inquiry (e.g. government-id, selfie, database, document). Returns JSON:API { data } with check results and PII. Persona REST: GET /verifications/{verification_id}.
| Argument | Type | Description |
|---|---|---|
| verification_id* | string | The verification id (e.g. ver_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"verification_id"
],
"properties": {
"verification_id": {
"type": "string",
"description": "The verification id (e.g. ver_...)."
}
}
}List accounts (a persistent identity record for an end user, linking their inquiries/verifications over time). Optionally filter by reference_id and paginate via the JSON:API links.next cursor (page_after) / links.prev (page_before). Returns JSON:API { data:[...], links } — objects contain PII. Persona REST: GET /accounts.
| Argument | Type | Description |
|---|---|---|
| page_size | integer | Page size — number of records per page. |
| page_after | string | Pagination cursor: return the page AFTER this record id (follow the links.next cursor). |
| page_before | string | Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor). |
| reference_id | string | Filter by your own reference-id set on the account. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Page size — number of records per page."
},
"page_after": {
"type": "string",
"description": "Pagination cursor: return the page AFTER this record id (follow the links.next cursor)."
},
"page_before": {
"type": "string",
"description": "Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor)."
},
"reference_id": {
"type": "string",
"description": "Filter by your own reference-id set on the account."
}
}
}List cases (manual-review workflow items grouping inquiries/reports for an analyst to adjudicate). Optionally filter by status, case_template_id, account_id, reference_id, inquiry_id, report_id, and paginate via the JSON:API links.next cursor (page_after) / links.prev (page_before). Returns JSON:API { data:[...], links } — objects contain PII. Persona REST: GET /cases.
| Argument | Type | Description |
|---|---|---|
| status | string | Filter by case status (e.g. open, resolved, waiting). |
| page_size | integer | Page size — number of records per page. |
| report_id | string | Filter by an associated report id. |
| account_id | string | Filter by the associated account id. |
| inquiry_id | string | Filter by an associated inquiry id. |
| page_after | string | Pagination cursor: return the page AFTER this record id (follow the links.next cursor). |
| page_before | string | Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor). |
| reference_id | string |
List audit-trail events (an immutable log of actions across your Persona account — inquiry/account/case state changes, etc.). Paginate via the JSON:API links.next cursor (page_after) / links.prev (page_before). Returns JSON:API { data:[...], links } — payloads may reference PII. Persona REST: GET /events.
| Argument | Type | Description |
|---|---|---|
| page_size | integer | Page size — number of records per page. |
| page_after | string | Pagination cursor: return the page AFTER this record id (follow the links.next cursor). |
| page_before | string | Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Page size — number of records per page."
},
"page_after": {
"type": "string",
"description": "Pagination cursor: return the page AFTER this record id (follow the links.next cursor)."
},
"page_before": {
"type": "string",
"description": "Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor)."
}
}
}List identity-verification inquiries (an end-user's KYC verification session). Optionally filter by status, account_id, reference_id, inquiry_template_id, and a created-at date range, and paginate via the JSON:API links.next cursor (page_after) / links.prev (page_before). Returns JSON:API { data:[...], links } — objects contain PII. Persona REST: GET /inquiries.
| Argument | Type | Description |
|---|---|---|
| status | string | Filter by inquiry status (e.g. created, pending, completed, failed, expired, approved, declined). |
| page_size | integer | Page size — number of records per page. |
| account_id | string | Filter by the associated account id. |
| page_after | string | Pagination cursor: return the page AFTER this record id (follow the links.next cursor). |
| page_before | string | Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor). |
| reference_id | string | Filter by your own reference-id set on the inquiry. |
| created_at_end | string | Filter: inquiries created at/before this ISO 8601 timestamp. |
List reports (screening/monitoring results such as watchlist, adverse-media, or business lookups). Paginate via the JSON:API links.next cursor (page_after) / links.prev (page_before). Returns JSON:API { data:[...], links } — objects may contain PII. Persona REST: GET /reports.
| Argument | Type | Description |
|---|---|---|
| page_size | integer | Page size — number of records per page. |
| page_after | string | Pagination cursor: return the page AFTER this record id (follow the links.next cursor). |
| page_before | string | Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Page size — number of records per page."
},
"page_after": {
"type": "string",
"description": "Pagination cursor: return the page AFTER this record id (follow the links.next cursor)."
},
"page_before": {
"type": "string",
"description": "Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor)."
}
}
}List transactions (records submitted for transaction fraud/monitoring analysis). Optionally filter by reference_id and transaction_type_id, and paginate via the JSON:API links.next cursor (page_after) / links.prev (page_before). Returns JSON:API { data:[...], links } — objects may contain PII. Persona REST: GET /transactions.
| Argument | Type | Description |
|---|---|---|
| page_size | integer | Page size — number of records per page. |
| page_after | string | Pagination cursor: return the page AFTER this record id (follow the links.next cursor). |
| page_before | string | Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor). |
| reference_id | string | Filter by your own reference-id set on the transaction. |
| transaction_type_id | string | Filter by the transaction type id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Page size — number of records per page."
},
"page_after": {
"type": "string",
"description": "Pagination cursor: return the page AFTER this record id (follow the links.next cursor)."
},
"page_before": {
"type": "string",
"description": "Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor)."
},
"reference_id": {
"type": "string",
"description": "Filter by your own reference-id set on the transaction."
},
"transaction_type_id": {
"type": "string",
"description": "Filter by the transaction type id."
}
}
}| Filter by your own reference-id set on the case. |
| case_template_id | string | Filter by the case template id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"status": {
"type": "string",
"description": "Filter by case status (e.g. open, resolved, waiting)."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Page size — number of records per page."
},
"report_id": {
"type": "string",
"description": "Filter by an associated report id."
},
"account_id": {
"type": "string",
"description": "Filter by the associated account id."
},
"inquiry_id": {
"type": "string",
"description": "Filter by an associated inquiry id."
},
"page_after": {
"type": "string",
"description": "Pagination cursor: return the page AFTER this record id (follow the links.next cursor)."
},
"page_before": {
"type": "string",
"description": "Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor)."
},
"reference_id": {
"type": "string",
"description": "Filter by your own reference-id set on the case."
},
"case_template_id": {
"type": "string",
"description": "Filter by the case template id."
}
}
}| created_at_start |
| string |
| Filter: inquiries created at/after this ISO 8601 timestamp. |
| inquiry_template_id | string | Filter by the inquiry template id (e.g. itmpl_...). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"status": {
"type": "string",
"description": "Filter by inquiry status (e.g. created, pending, completed, failed, expired, approved, declined)."
},
"page_size": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Page size — number of records per page."
},
"account_id": {
"type": "string",
"description": "Filter by the associated account id."
},
"page_after": {
"type": "string",
"description": "Pagination cursor: return the page AFTER this record id (follow the links.next cursor)."
},
"page_before": {
"type": "string",
"description": "Pagination cursor: return the page BEFORE this record id (follow the links.prev cursor)."
},
"reference_id": {
"type": "string",
"description": "Filter by your own reference-id set on the inquiry."
},
"created_at_end": {
"type": "string",
"description": "Filter: inquiries created at/before this ISO 8601 timestamp."
},
"created_at_start": {
"type": "string",
"description": "Filter: inquiries created at/after this ISO 8601 timestamp."
},
"inquiry_template_id": {
"type": "string",
"description": "Filter by the inquiry template id (e.g. itmpl_...)."
}
}
}