Tools reference - Didit Documentation

The Didit MCP exposes 110+ tools. Each calls a single Didit REST endpoint and returns the JSON response verbatim, so anything in the verification API or auth API 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):

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).

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.

Examples

Prompts and end-to-end conversations.

Advanced

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

​Discovery & cross-app

​Sessions (KYC & KYB)

​Workflows & questionnaires

​Verification APIs (standalone)

​Transaction monitoring (AML)

​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)

Vendor users & businesses

Lists, blocklist & allowlist

Cases (investigations)

Reports, audit & alerts

Webhooks

Workspace: account, organization & billing