Tools reference

The Didit MCP exposes 150 tools to ordinary users over the hosted OAuth endpoint (156 in the full local catalogue). Together they cover verification, workspace management, transaction monitoring, and reporting operations from the verification API and auth API. Tool availability still follows your OAuth scopes and console role. Tools are typed so your client can group and gate them:

Badge	Meaning
Read	Safe, read-only.
Write	Creates or mutates a resource.
Destructive	Deletes data, reveals a secret, or moves money — your client asks for explicit confirmation.

The didit_verify_* standalone tools are billable POST actions — they consume credits even though some read like a query (e.g. face_search, kyb_search).

Discovery & cross-app

Start here. These span every organization and application you can access in a single call, each result tagged with its org/app.

Tool	Type	Description
`didit_context_get`	Read	List all your organizations and applications in one call. Call this first to discover IDs.
`didit_session_search`	Read	Search KYC/KYB sessions across all apps; newest first.
`didit_transaction_search`	Read	Search transaction-monitoring records across all apps.
`didit_case_search`	Read	Search investigation/compliance cases across all apps.
`didit_vendor_user_search`	Read	Find an end customer (by name/email/`vendor_data`) across all apps.
`didit_vendor_business_search`	Read	Find a KYB business across all apps.
`didit_analytics`	Read	Aggregate analytics over a date window — request breakdown, feature funnel, conversion rate — across all apps.

Sessions (KYC & KYB)

Tool	Type	Description
`didit_session_create`	Write	Create a verification session; returns `session_id`, `session_token`, and a hosted `url`.
`didit_session_list`	Read	List sessions with filters (auto-spans all apps when unscoped).
`didit_session_get_decision`	Read	Full decision and extracted data (V3 plural arrays).
`didit_session_update_status`	Write	Approve, decline, or request resubmission.
`didit_session_update_data`	Write	Override extracted document (KYC) data.
`didit_session_update_poa_data`	Write	Override extracted proof-of-address data.
`didit_session_add_review`	Write	Add a reviewer note (optionally change status).
`didit_session_list_reviews`	Read	Manual-review audit trail.
`didit_session_generate_pdf`	Read	Generate a compliance PDF report.
`didit_session_share`	Write	Mint a Reusable KYC share token.
`didit_session_import_shared`	Write	Redeem a Reusable KYC share token.
`didit_session_delete`	Destructive	Permanently delete a single session - its verification data and stored media (requires `confirm: true`; irreversible); previously issued media URLs stop resolving. Blocklist entries, issued share tokens, already-queued webhook deliveries, consumed credits, and the parent user/business are not affected.
`didit_session_batch_delete`	Destructive	Permanently delete many KYC sessions at once by `session_numbers`, or every KYC session in the application with `delete_all` (requires `confirm: true`; irreversible). KYB sessions are never touched - delete those individually. Each deleted session follows the same erasure boundary as `didit_session_delete`.

Bulk import

Tool	Type	Description
`didit_session_create_import`	Write	Start a bulk import from a CSV/NDJSON URL.
`didit_session_get_import_template`	Read	Download the import CSV template.
`didit_session_get_import`	Read	Check import job status.
`didit_session_get_import_errors`	Read	List per-row import failures.

Workflows & questionnaires

Tool	Type	Description
`didit_workflow_list`	Read	List verification workflows (auto-spans all apps).
`didit_workflow_search`	Read	Find a workflow by id or label across all apps in one call (returns which org/app owns it).
`didit_workflow_get`	Read	Read one workflow version.
`didit_workflow_create`	Write	Create a SIMPLE (linear) workflow from a feature list.
`didit_workflow_update`	Write	Update a simple workflow’s settings or feature list.
`didit_workflow_delete`	Destructive	Delete a workflow version.
`didit_questionnaire_list`	Read	List custom questionnaires.
`didit_questionnaire_get`	Read	Get questionnaire details.
`didit_questionnaire_create`	Write	Create a questionnaire (`form_elements`).
`didit_questionnaire_update`	Write	Update a questionnaire.
`didit_questionnaire_delete`	Destructive	Delete a questionnaire.

Branching / graph workflows — for conditional routing, Document-AI steps, and decline/decision nodes (see Advanced → Branching workflows):

Tool	Type	Description
`didit_workflow_get_graph`	Read	Get a workflow’s node graph + status / editability. Big feature configs (`documents_allowed`, …) are summarized by default so it never overflows; `include_config:true` for raw.
`didit_workflow_get_field_definitions`	Read	List branchable fields + valid operators (e.g. `kyc.extra_fields.profession` → `fuzzy_match`).
`didit_workflow_get_branch_fields`	Read	Fields available at a specific branch point in a candidate graph.
`didit_workflow_validate_graph`	Read	Dry-run validate a full graph (no save).
`didit_workflow_edit_graph`	Write	Modify an existing workflow with small ops (`set_next`/`set_node`/`set_branches`/`merge_node_config`). Fetches the full graph server-side, so huge allow-lists are preserved and never resent. Auto-drafts; publish opt-in. Prefer this for edits.
`didit_workflow_set_graph`	Write	Replace the entire graph — only for building a small/new workflow from scratch (you’d otherwise resend every node). Auto-drafts; publish opt-in.
`didit_workflow_create_draft`	Write	Create an editable draft from a published workflow.
`didit_workflow_publish`	Write	Publish a draft version (live for new sessions).
`didit_workflow_get_id_verification_methods_catalog`	Read	The ID Verification methods capability catalog: per country, whether non-doc lookup is offered and which digital ID wallets are, their availability (`available` can be enabled, `coming_soon` cannot), the plain-language request and response fields, and the lookup catalog prices. Pass `country` (ISO3) to narrow it to one country.

Read the catalog before writing the methods key on an ID Verification (OCR) node with didit_workflow_edit_graph or didit_workflow_set_graph. A method or a wallet the catalog does not mark available for that country is rejected on save, wallets are an accept-list with no ordering, and every lookup price in the catalog is a placeholder until the pricing catalog is published. The methods reference has the full shape.

Verification APIs (standalone)

No session required — single billable calls. Great for one-off checks and pipelines.

Tool	Type	Description
`didit_verify_id`	Write	Document OCR + authenticity.
`didit_verify_poa`	Write	Proof-of-address extraction + validation.
`didit_verify_database`	Write	Validate identity against authoritative databases.
`didit_verify_kyb_search`	Write	Search company registries.
`didit_verify_kyb_select`	Write	Resolve a candidate to a full company record.
`didit_verify_passive_liveness`	Write	Liveness from a single image.
`didit_verify_face_match`	Write	1:1 face comparison.
`didit_verify_face_search`	Write	1:N face search against a verified database.
`didit_verify_age`	Write	Age estimation from a facial image.
`didit_verify_aml`	Write	AML / sanctions / PEP / adverse-media screening.
`didit_verify_email_send`	Write	Send an email verification code.
`didit_verify_email_check`	Write	Verify an email OTP code.
`didit_verify_phone_send`	Write	Send a phone code (SMS / WhatsApp / voice / RCS / Telegram).
`didit_verify_phone_check`	Write	Verify a phone OTP code.

Transaction monitoring (AML)

Tool	Type	Description
`didit_transaction_list`	Read	List monitored transactions.
`didit_transaction_get`	Read	One transaction — verdict, hits, score.
`didit_transaction_create`	Write	Submit a transaction for rules + AML evaluation.
`didit_transaction_screen_wallet`	Write	Screen a crypto wallet (no session created).
`didit_transaction_sdk_token`	Write	Mint a scoped token for client-side SDK submission.
`didit_transaction_rule_list`	Read	List KYT rules with source/category/mode filters and performance ordering.
`didit_transaction_rule_get`	Read	One rule - full configuration plus execution counters.
`didit_transaction_rule_create`	Write	Create a custom rule (conditions, velocity, actions). Prefer TEST mode first.
`didit_transaction_rule_update`	Write	Tune a custom rule; switch any rule’s mode (presets: mode only).
`didit_transaction_rule_delete`	Destructive	Delete a custom rule. Permanent.
`didit_transaction_rule_backtest`	Read	Evaluate a hypothetical rule against transaction history.
`didit_transaction_rule_library_list`	Read	Browse the 150+ preset library with install status.
`didit_transaction_rule_install`	Write	Install presets by library key or bundle.
`didit_transaction_rule_uninstall`	Destructive	Remove installed presets (reinstallable anytime).

Travel Rule

The FATF / EU TFR managed exchange: settings, the VASP directory, the wallet address book, transfer actions, and wallet-ownership proofs.

Tool	Type	Description
`didit_travel_rule_get_settings`	Read	Settings + VASP profile, network modes, your travel address.
`didit_travel_rule_update_settings`	Write	Enable Travel Rule, tune policy, opt out of networks (partial update).
`didit_travel_rule_search_vasps`	Read	Search the VASP directory (due-diligence scores, reachable rails).
`didit_travel_rule_list_wallet_addresses`	Read	List the wallet address book with ownership state.
`didit_travel_rule_add_wallet_address`	Write	Register a wallet (optionally pre-verified by self-declaration).
`didit_travel_rule_update_wallet_address`	Write	Update holder metadata / travel address on an entry.
`didit_travel_rule_delete_wallet_address`	Destructive	Delete an entry (stops matching immediately).
`didit_travel_rule_transfer_action`	Write	Finish (report on-chain hash), cancel, or resend a transfer.
`didit_travel_rule_confirm_ownership`	Write	Confirm or deny wallet ownership on a pending transfer.
`didit_travel_rule_register_inbound`	Write	Register an already-settled deposit (sunrise flow).
`didit_travel_rule_create_widget_session`	Write	Mint a hosted wallet-ownership widget link.

Marketplace

Tool	Type	Description
`didit_marketplace_list_catalog`	Read	Provider catalog: crypto monitoring, AML screening, phone verification, and Travel Rule networks with provider credential schemas.
`didit_marketplace_list_connections`	Read	Your connected providers and network memberships (secrets never returned).
`didit_marketplace_request_integration`	Write	Request an on-request integration (CODE, TRISA, Notabene, Veriscope, or any provider).

Vendor users & businesses

Tool	Type	Description
`didit_vendor_user_list`	Read	List verified users (grouped by `vendor_data`).
`didit_vendor_user_get`	Read	Get a user by `vendor_data`.
`didit_vendor_user_create`	Write	Create a user record.
`didit_vendor_user_update`	Write	Update user metadata.
`didit_vendor_user_update_status`	Write	Set `ACTIVE` / `FLAGGED` / `BLOCKED`.
`didit_vendor_user_delete`	Destructive	Batch-delete users.
`didit_vendor_business_list`	Read	List verified businesses.
`didit_vendor_business_get`	Read	Get a business by `vendor_data`.
`didit_vendor_business_create`	Write	Create a business record.
`didit_vendor_business_update`	Write	Update business metadata.
`didit_vendor_business_update_status`	Write	Set `ACTIVE` / `FLAGGED` / `BLOCKED`.
`didit_vendor_business_delete`	Destructive	Batch-delete businesses.

Lists, blocklist & allowlist

Tool	Type	Description
`didit_lists_list`	Read	List all blocklists, allowlists, and custom lists.
`didit_lists_get`	Read	Get one list.
`didit_lists_create`	Write	Create an allowlist or custom list.
`didit_lists_update`	Write	Rename / update a list.
`didit_lists_delete`	Destructive	Delete a list.
`didit_lists_entries_list`	Read	List entries in a list.
`didit_lists_entry_create`	Write	Add an entry (by value or from a session).
`didit_lists_entry_upload_face`	Write	Add a face from an image (no session).
`didit_lists_entry_delete`	Destructive	Remove an entry.
`didit_blocklist_get`	Read	List blocklist entries (legacy helper).
`didit_blocklist_add`	Write	Add to the blocklist (legacy helper).
`didit_allowlist_add`	Write	Add to the allowlist (legacy helper).
`didit_blocklist_remove`	Destructive	Remove from the blocklist (legacy helper).

Cases (investigations)

Tool	Type	Description
`didit_case_list`	Read	List cases.
`didit_case_get`	Read	Get a case.
`didit_case_statistics`	Read	Case counts by status.
`didit_case_create`	Write	Open a case.
`didit_case_manage`	Destructive	Act on a case (assign / resolve / escalate / comment).

Reports, audit & alerts

Tool	Type	Description
`didit_report_list`	Read	List export jobs.
`didit_report_get`	Read	Check an export job’s status.
`didit_report_get_download_url`	Read	Get a signed download URL.
`didit_report_export`	Write	Start an export (sessions / transactions / users / businesses).
`didit_audit_log_list`	Read	List audit-log entries.
`didit_alert_list`	Read	List configured alerts.
`didit_alert_configure`	Write	Configure an alert.

Webhooks

Tool	Type	Description
`didit_webhook_list`	Read	List webhook destinations.
`didit_webhook_get`	Read	Read a destination (incl. signing secret).
`didit_webhook_create`	Write	Create a destination; returns the signing secret.
`didit_webhook_update`	Write	Update URL / version / subscribed events.
`didit_webhook_delete`	Destructive	Delete a destination.

Workspace: account, organization & billing

The didit_account_* tools are available only on the local stdio server (npx @didit-protocol/mcp-server), where they bootstrap your first credentials. The hosted connector authenticates with OAuth, so it never asks for account credentials in the conversation and does not expose these four tools.

Tool	Type	Description
`didit_account_register`	Write	Register a new account; emails a verification code. Local server only.
`didit_account_verify_email`	Write	Verify the code; returns `api_key` + tokens. Local server only.
`didit_account_resend_otp`	Write	Resend the verification code. Local server only.
`didit_account_login`	Write	Log in to an existing account. Local server only.
`didit_context_get`	Read	All organizations + applications in one call.
`didit_org_list`	Read	List organizations.
`didit_org_list_applications`	Read	List applications in an organization.
`didit_org_get_application`	Read	Application details (API key redacted).
`didit_org_get_balance`	Read	Credit balance.
`didit_org_list_members`	Read	List organization members.
`didit_org_list_roles`	Read	List available roles.
`didit_org_list_api_keys`	Read	List API keys.
`didit_org_invite_member`	Write	Invite a member by email.
`didit_org_update_member`	Write	Change a member’s role.
`didit_org_remove_member`	Destructive	Remove a member.
`didit_org_top_up`	Destructive	Create a Stripe checkout to add credits (moves money).
`didit_org_reveal_application_api_key`	Destructive	Reveal a live application API key (requires `confirm: true`).
`didit_branding_get`	Read	Get current branding.
`didit_branding_update`	Write	Upload logos / favicon.

Examples

Prompts and end-to-end conversations.

Advanced

Scopes, cross-app behavior, response shape, webhooks.

Guides

Model Context Protocol (MCP)

Web SDKs

Native SDKs

Integrations

Discovery & cross-app

Sessions (KYC & KYB)

Workflows & questionnaires

Verification APIs (standalone)

Transaction monitoring (AML)

Travel Rule

Marketplace

Vendor users & businesses

Lists, blocklist & allowlist

Cases (investigations)

Reports, audit & alerts

Webhooks

Workspace: account, organization & billing

Examples

Advanced

​Discovery & cross-app

​Sessions (KYC & KYB)

​Workflows & questionnaires

​Verification APIs (standalone)

​Transaction monitoring (AML)

​Travel Rule

​Marketplace

​Vendor users & businesses

​Lists, blocklist & allowlist

​Cases (investigations)

​Reports, audit & alerts

​Webhooks

​Workspace: account, organization & billing

Examples

Advanced

Discovery & cross-app

Sessions (KYC & KYB)

Workflows & questionnaires

Verification APIs (standalone)

Transaction monitoring (AML)

Travel Rule

Marketplace

Vendor users & businesses

Lists, blocklist & allowlist

Cases (investigations)

Reports, audit & alerts

Webhooks

Workspace: account, organization & billing