Get Started
Integrate / SDKs
User Verification
Business Verification
Transaction Monitoring
Changelog| 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. |
| 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. |
| 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). |
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. |
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, Travel Rule networks (with BYOK 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.