> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.
# Tools reference
> Every tool the Didit MCP exposes — sessions, workflows, KYB, AML, transaction monitoring, biometrics, lists, cases, reports, webhooks, billing — grouped by area, with read/write/destructive markers.
The Didit MCP exposes **130+ tools**. Each calls a single Didit REST endpoint and returns the JSON response verbatim, so anything in the [verification API](/openapi-25.json) or [auth API](/openapi-auth.json) is reachable from a prompt.
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 | Delete a single session. |
| `didit_session_batch_delete` | Destructive | Delete many sessions at once. |
**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](/integration/mcp/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). |
***
## 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](/transaction-monitoring/sdk-transaction-submission). |
***
## Travel Rule
The [FATF / EU TFR managed exchange](/transaction-monitoring/travel-rule): 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 | Soft-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](/transaction-monitoring/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
| Tool | Type | Description |
| -------------------------------------- | ----------- | ------------------------------------------------------------- |
| `didit_account_register` | Write | Register a new account; emails a verification code. |
| `didit_account_verify_email` | Write | Verify the code; returns `api_key` + tokens. |
| `didit_account_resend_otp` | Write | Resend the verification code. |
| `didit_account_login` | Write | Log in to an existing account. |
| `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. |
***
Prompts and end-to-end conversations.
Scopes, cross-app behavior, response shape, webhooks.