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

# Didit MCP 工具参考：169 个身份工具

> Didit 托管 MCP 服务器提供的全部工具，按功能分组，并列出每个工具的读/写/破坏性类型、OAuth 权限范围及所需角色权限。

`https://mcp.didit.me/mcp` 上的托管服务器为已登录用户提供 **169 个工具**：80 个读取类工具、62 个写入类工具和 27 个 **破坏性** 工具。
另有 17 个 [Investigator 工具](#调查员) 也会列出，但只有在您的组织启用 Investigator 后才能使用。
另外两个工具（`didit_org_top_up` 和 `didit_org_reveal_application_api_key`）对所有 OAuth 认证的目录都隐藏，只出现在本地 stdio 服务器上。该服务器还会额外提供五个账户设置工具（参见 [自托管](https://docs.didit.me/zh/integration/mcp/installation.md#自托管)）。

本页根据 [`didit-protocol/mcp`](https://github.com/didit-protocol/mcp) 中的工具注册表生成（`src/index.ts`，即托管服务器在 `serverInfo` 中报告的版本）。名称、类型和必需参数来自服务器自身的 `tools/list` 响应；角色权限来自 `src/permissions.ts`。

## 如何阅读此表

| 列 | 含义 |
| - | - |
| **类型** | 来自工具的 MCP 注解。**读取** 为只读。**写入** 会创建或更改某些内容。**破坏性** 会删除或覆盖数据、更改会立即生效的内容（已发布的工作流、会话决策）、揭示秘密或转移资金；客户端在运行这些工具前会要求确认。计费的独立检查算作写入。 |
| **范围** | 其资源包含该工具角色权限的 OAuth 范围：`didit:verification` 适用于会话、企业、案件、网络、交易和黑名单；`didit:management` 适用于工作流、问卷、名单、Webhook、集成、成员、角色、API 密钥、审计日志、组织、应用、订阅和用户。**任一** 表示分析功能（两个范围都包含），或没有按角色检查的工具，该工具会在您批准的任一范围下运行。参见 [身份验证](https://docs.didit.me/zh/integration/mcp/authentication.md#作用域)。 |
| **角色权限** | 您的组织角色必须具备的权限，由 Didit 后端检查。破折号表示该 endpoint 按成员范围限定或没有按角色检查。若您的角色缺少该权限，工具会返回 `missing_scope` 错误并指明该权限。 |

每个工具都接受可选的 `organization_id` 和 `application_id` 来固定范围。若只有一个组织和一个应用，系统会自动解析；若有多个，`*_search` 工具和 `didit_analytics` 会跨越全部范围，而按应用划分的 `*_list` 工具在您不传入范围时也是如此。

> [!NOTE]
>
> `didit_session_delete` 和 `didit_session_batch_delete` 在参数中没有 `confirm: true` 时会拒绝运行，Investigator 决策工具（`accept`、`override`、`batch_accept`、`rereview`、`question_answer`、`question_dismiss`）以及仅限本地的 `didit_org_reveal_application_api_key` 同样如此。`didit_case_manage` 在提交 SAR 时需要该参数，`didit_vendor_user_delete` 和 `didit_vendor_business_delete` 在 `delete_all` 为 true 时需要该参数。

***

## 发现与跨应用

以下工具可在单次调用中跨越您可访问的所有组织和应用；每行均标注了其所属的组织和应用。

| 工具 | 类型 | 范围 | 角色权限 | 功能 |
| - | - | - | - | - |
| `didit_context_get` | 读取 | 任一 | — | 您可访问的所有组织和应用（嵌套结构）；若只有一个组织和应用，还会返回默认的组织和应用。请先调用此工具。 |
| `didit_session_search` | 读取 | `didit:verification` | `list:sessions` | 跨所有应用和组织搜索验证会话，按最新排序。 |
| `didit_transaction_search` | 读取 | `didit:verification` | `list:transactions` | 跨所有应用和组织搜索受监控的交易。 |
| `didit_case_search` | 读取 | `didit:verification` | `list:cases` | 跨所有应用和组织搜索调查案件。 |
| `didit_vendor_user_search` | 读取 | `didit:management` | `list:users` | 按姓名、邮箱或 `vendor_data` 在所有应用中查找终端客户。 |
| `didit_vendor_business_search` | 读取 | `didit:verification` | `list:businesses` | 在所有应用中查找 KYB 企业。 |
| `didit_workflow_search` | 读取 | `didit:management` | `read:workflows` | 按 ID 或标签在所有应用中查找工作流；结果会说明归属的组织和应用。 |
| `didit_analytics` | 读取 | 任一 | `read:analytics` | 跨所有应用按日期范围汇总分析数据（请求细分、功能漏斗、转化率）。 |

***

## 会话 (KYC 和 KYB)

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_session_create` | 写入 | `didit:verification` | `create:sessions` 或 `write:sessions` | 为某个工作流创建验证会话。返回 `session_id`、`url` 和 `session_token`。 |
| `didit_session_list` | 读取 | `didit:verification` | `list:sessions` | 列出某一应用中的会话。未指定范围时，跨所有应用列出。 |
| `didit_session_get_decision` | 读取 | `didit:verification` | `read:sessions` | 某个会话的完整决策结果及所有提取的数据。 |
| `didit_session_get_location_evidence` | 读取 | `didit:verification` | `read:sessions` | 某个会话在每个位置步骤中的精确位置证据：做出判定的配置、结论、每次尝试、参考点、距离和区域。 |
| `didit_session_update_status` | 破坏性 | `didit:verification` | `write:sessions` | 通过、拒绝或要求重新提交某个会话。 |
| `didit_session_update_data` | 写入 | `didit:verification` | `write:sessions` | 更正从身份证件中提取的数据（审核员手动覆盖）。 |
| `didit_session_update_poa_data` | 写入 | `didit:verification` | `write:sessions` | 更正从地址证明文件中提取的数据。 |
| `didit_session_delete` | 破坏性 | `didit:verification` | `delete:sessions` | 永久删除一个会话及其验证数据和媒体文件。需要 `confirm: true`。 |
| `didit_session_batch_delete` | 破坏性 | `didit:verification` | `delete:sessions` | 按会话编号永久删除多个 KYC 会话，或删除应用中的所有 KYC 会话。需要 `confirm: true`。KYB 会话永远不会受影响。 |
| `didit_session_generate_pdf` | 写入 | `didit:verification` | `read:sessions` | 为某个会话生成 PDF 验证报告。 |
| `didit_session_list_reviews` | 读取 | `didit:verification` | `read:sessions` | 某个会话的审核历史和活动日志。 |
| `didit_session_add_review` | 写入 | `didit:verification` | `write:sessions` | 为某个会话添加审核备注，并可选择更改其状态。 |
| `didit_session_share` | 写入 | `didit:verification` | `write:sessions` | 与受信任的合作伙伴共享已验证的会话（可复用 KYC）。 |
| `didit_session_import_shared` | 写入 | 两者皆可 | — | 导入合作伙伴与您共享的会话（可复用 KYC）。 |
| `didit_session_create_import` | 写入 | 两者皆可 | — | 从托管的 CSV 或 NDJSON 文件启动批量导入任务。 |
| `didit_session_get_import_template` | 读取 | 两者皆可 | — | 下载导入模板（列标题和格式）。 |
| `didit_session_get_import` | 读取 | 两者皆可 | — | 批量导入任务的状态和摘要。 |
| `didit_session_get_import_errors` | 读取 | 两者皆可 | — | 批量导入任务中每行的失败记录。 |
| `didit_session_explain_decision` | 读取 | `didit:verification` | `read:sessions` | 说明会话为何被判定为已通过、已拒绝或审核中：起决定作用的特征、每个产生影响的警告、每条被触发的状态规则、任何审核员手动覆盖，以及每个原因背后的工作流设置。 |
| `didit_session_webhooks` | 读取 | `didit:verification` | `read:sessions` | 过去 30 天内为某个会话发送的 Webhook 投递记录：目标、HTTP 状态、耗时、签名请求头，以及有大小上限的 payload 副本。 |
| `didit_session_webhook_resend` | 写入 | `didit:verification` | `create:sessions` | 将某个会话的一条已记录的 Webhook 投递重新发送到已配置的 endpoint，例如 endpoint 修复之后。 |

***

## 工作流

简单工作流是扁平的功能列表；图结构工作流则增加分支、条件和 Document AI 步骤。参见[进阶：分支工作流](https://docs.didit.me/zh/integration/mcp/advanced.md#分支工作流)。

| 工具 | 类型 | 范围 | 角色权限 | 作用 |
| - | - | - | - | - |
| `didit_workflow_list` | 读取 | `didit:management` | `read:workflows` | 列出验证工作流。未指定范围时跨所有应用。 |
| `didit_workflow_create` | 写入 | `didit:management` | `write:workflows` | 根据有序功能列表创建简单的线性工作流。除非传入 `status: "draft"`，否则直接发布。 |
| `didit_workflow_get` | 读取 | `didit:management` | `read:workflows` | 单个工作流的完整配置，包括每个功能返回哪些数据点。 |
| `didit_workflow_update` | 破坏性 | `didit:management` | `write:workflows` | 修改工作流的顶层设置（名称、默认标记、重试、过期时间、白标、白名单）。 |
| `didit_workflow_delete` | 破坏性 | `didit:management` | `write:workflows` | 删除草稿工作流。 |
| `didit_workflow_get_graph` | 读取 | `didit:management` | `read:workflows` | 工作流的节点图，包括其状态和可编辑性。除非你要求，否则大型配置会被汇总。 |
| `didit_workflow_get_field_definitions` | 读取 | `didit:management` | `read:workflows` | 所有可用于分支判断的字段，以及每个字段接受的运算符。 |
| `didit_workflow_get_feature_config_schema` | 读取 | 任一 | — | 每个工作流功能接受的所有 `config` 键，包括类型、取值范围、默认值和含义。 |
| `didit_workflow_get_id_verification_methods_catalog` | 读取 | `didit:management` | `read:workflows` | 按国家/地区列出提供的非证件查询和数字身份钱包、是否已上线以及查询目录价格。 |
| `didit_workflow_get_kyb_registry_catalog` | 读取 | 任一 | — | 按国家/地区列出公司登记机构提供的企业数据等级，以及是否提供登记监控，附价格。无需组织或应用。 |
| `didit_workflow_get_branch_fields` | 读取 | `didit:management` | `read:workflows` | 候选图中某个分支节点可用的字段。 |
| `didit_workflow_validate_graph` | 读取 | `didit:management` | `read:workflows` | 对完整图进行试运行校验，不保存任何内容。 |
| `didit_workflow_edit_graph` | 破坏性 | `didit:management` | `write:workflows` | 通过小步操作修改现有图；服务器自行获取完整图并保存为草稿。 |
| `didit_workflow_set_graph` | 破坏性 | `didit:management` | `write:workflows` | 替换工作流的整个图。保存为草稿；发布是单独的步骤。 |
| `didit_workflow_create_draft` | 写入 | `didit:management` | `write:workflows` | 基于已发布的工作流创建可编辑草稿。 |
| `didit_workflow_publish` | 破坏性 | `didit:management` | `write:workflows` | 发布待发布的草稿，使新会话使用该草稿。 |
| `didit_workflow_build_graph` | 读取 | `didit:management` | `read:workflows` | 根据简单的功能规格构建完整的图，不保存任何内容。 |

***

## 合规助手

根据你的监管画像构建工作流：自适应访谈、适用于你的合规义务（附引用依据），以及生成的多国工作流。

| 工具 | 类型 | 范围 | 角色权限 | 作用 |
| - | - | - | - | - |
| `didit_compliance_interview_next` | 读取 | `didit:management` | `read:workflows` | 自适应合规访谈的下一个问题；访谈完成时返回 `done`。每次调用都需传入目前收集的所有答案。 |
| `didit_compliance_profile_get` | 读取 | `didit:management` | `read:workflows` | 你已保存的合规档案：访谈答案以及由此推导的属性。 |
| `didit_compliance_profile_set` | 破坏性 | `didit:management` | `write:workflows` | 保存已完成的访谈答案，替换任何现有合规档案。 |
| `didit_compliance_requirements` | 读取 | `didit:management` | `read:workflows` | 根据已保存的档案推导出适用于你的监管义务，附引用依据。 |
| `didit_compliance_generate_workflow` | 读取 | `didit:management` | `read:workflows` | 根据已保存的档案生成多国工作流图：包含共同主干，以及各国分支，每个分支带有该国要求的检查项。 |
| `didit_compliance_check_workflow` | 读取 | `didit:management` | `read:workflows` | 检查某个工作流版本满足或违反了哪些义务，附引用依据。 |

***

## 问卷

| 工具 | 类型 | 范围 | 角色权限 | 作用 |
| - | - | - | - | - |
| `didit_questionnaire_list` | 读取 | `didit:management` | `read:questionnaires` | 列出应用的自定义问卷。 |
| `didit_questionnaire_create` | 写入 | `didit:management` | `write:questionnaires` | 根据有序的问题列表创建问卷。 |
| `didit_questionnaire_append_choices` | 写入 | `didit:management` | `write:questionnaires` | 为草稿问卷中的某个问题追加答案选项。 |
| `didit_questionnaire_get` | 读取 | `didit:management` | `read:questionnaires` | 单个问卷的问题和选项。 |
| `didit_questionnaire_update` | 破坏性 | `didit:management` | `write:questionnaires` | 更新问卷的标题、描述或问题。 |
| `didit_questionnaire_delete` | 破坏性 | `didit:management` | `write:questionnaires` | 删除问卷。 |

***

## 独立验证 API

单次计费调用，不创建会话。这些调用均为 POST 请求，且都会消耗积分，即使看起来只是查询的调用（`kyb_search`、`face_search`）也是如此。

| 工具 | 类型 | 范围 | 角色权限 | 功能 |
| - | - | - | - | - |
| `didit_verify_id` | 写入 | `didit:verification` | `create:sessions` | 根据身份证件的正面图像（可选背面图像）验证身份证件。 |
| `didit_verify_poa` | 写入 | `didit:verification` | `create:sessions` | 验证地址证明文件。 |
| `didit_verify_database` | 写入 | `didit:verification` | `create:sessions` | 将身份数据与国家及全球权威数据源进行核对。 |
| `didit_verify_kyb_search` | 写入 | `didit:verification` | `create:sessions` | 按名称或注册号搜索官方公司登记处；返回候选企业。 |
| `didit_verify_kyb_select` | 写入 | `didit:verification` | `create:sessions` | 获取 `didit_verify_kyb_search` 返回的某个候选企业的完整登记记录。 |
| `didit_verify_passive_liveness` | 写入 | `didit:verification` | `create:sessions` | 基于单张图像的被动活体检测。 |
| `didit_verify_face_match` | 写入 | `didit:verification` | `create:sessions` | 比对两张人脸图像（1:1）。 |
| `didit_verify_face_search` | 写入 | `didit:verification` | `create:sessions` | 在已验证的人脸中搜索某张人脸（1:N）。 |
| `didit_verify_age` | 写入 | `didit:verification` | `create:sessions` | 根据人脸图像估算一个人的年龄。 |
| `didit_verify_aml` | 写入 | `didit:verification` | `create:sessions` | 对姓名进行制裁、PEP 和观察名单筛查，可选择加入负面新闻筛查。 |
| `didit_verify_email_send` | 写入 | 任一 | — | 向邮箱地址发送一次性验证码。 |
| `didit_verify_email_check` | 写入 | 任一 | — | 核对发送至邮箱地址的验证码。 |
| `didit_verify_phone_send` | 写入 | 任一 | — | 向电话号码发送一次性验证码。 |
| `didit_verify_phone_check` | 写入 | 任一 | — | 核对发送至电话号码的验证码。 |

***

## 交易监控

| 工具 | 类型 | 范围 | 角色权限 | 功能 |
| - | - | - | - | - |
| `didit_transaction_list` | 读取 | `didit:verification` | `list:transactions` | 列出一个应用中受监控的交易。未提供范围时，覆盖所有应用。 |
| `didit_transaction_create` | 写入 | `didit:verification` | `create:transactions` | 提交交易以进行监控和规则评估。 |
| `didit_transaction_get` | 读取 | `didit:verification` | `list:transactions` | 获取一笔受监控交易及其规则评估结果。 |
| `didit_transaction_screen_wallet` | 写入 | `didit:verification` | `create:transactions` | 对加密钱包地址进行 AML 风险筛查，不创建交易。 |
| `didit_transaction_rule_list` | 读取 | `didit:verification` | `list:transactions` | 列出应用的交易监控规则。 |
| `didit_transaction_rule_get` | 读取 | `didit:verification` | `list:transactions` | 获取一条规则及其条件、聚合、范围、操作和计数器。 |
| `didit_transaction_rule_create` | 写入 | `didit:verification` | `write:transactions` | 创建自定义规则。 |
| `didit_transaction_rule_update` | 写入 | `didit:verification` | `write:transactions` | 部分更新一条规则。 |
| `didit_transaction_rule_delete` | 破坏性操作 | `didit:verification` | `write:transactions` | 删除自定义规则。 |
| `didit_transaction_rule_backtest` | 读取 | `didit:verification` | `list:transactions` | 用一条假设规则对最近的至多 10,000 笔交易进行模拟运行。不写入任何数据。 |
| `didit_transaction_rule_library_list` | 读取 | `didit:verification` | `list:transactions` | 浏览 Didit 预设规则库及其安装状态。 |
| `didit_transaction_rule_install` | 写入 | `didit:verification` | `write:transactions` | 通过规则库键或规则包安装预设规则。 |
| `didit_transaction_rule_uninstall` | 破坏性操作 | `didit:verification` | `write:transactions` | 通过规则库键或规则包移除已安装的预设规则。 |
| `didit_transaction_sdk_token` | 写入 | 任一 | — | 签发一个与单个终端用户绑定的短期 token，用于通过客户端 SDK 提交交易。 |

***

## Travel Rule

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_travel_rule_get_settings` | 读取 | 任一 | — | 您的 Travel Rule 设置：VASP 资料、协商策略、证明方式、各网络模式，以及您的 Travel Address。 |
| `didit_travel_rule_update_settings` | 写入 | 任一 | — | 修改 Travel Rule 设置；仅发送需要更改的字段。启用时需要提供法定名称。 |
| `didit_travel_rule_search_vasps` | 读取 | 任一 | — | 搜索 VASP 目录，结果包含尽职调查分数，以及各 VASP 可通过的网络。 |
| `didit_travel_rule_list_wallet_addresses` | 读取 | 任一 | — | 入站转账所匹配的钱包地址簿，并显示每个地址的所有权验证状态。 |
| `didit_travel_rule_add_wallet_address` | 写入 | 任一 | — | 将您控制的钱包添加到地址簿，可选择通过自我声明将其标记为已完成所有权验证。 |
| `didit_travel_rule_update_wallet_address` | 写入 | 任一 | — | 更新地址簿条目的持有人信息。 |
| `didit_travel_rule_delete_wallet_address` | 破坏性操作 | 任一 | — | 删除地址簿条目；删除后，该条目将立即停止匹配新转账。 |
| `didit_travel_rule_confirm_ownership` | 破坏性操作 | 任一 | — | 在等待所有权证明的转账中，确认或否认钱包所有权。 |
| `didit_travel_rule_transfer_action` | 破坏性操作 | 任一 | — | 通过链上哈希完成出站转账，取消未达到最终状态的转账，或重新执行交易对手路由。 |
| `didit_travel_rule_get_vasp` | 读取 | 任一 | — | 按 ID 获取单个 VASP 目录条目，字段与搜索结果行相同：包括路由、网络列表、别名、联系人和实体。 |
| `didit_travel_rule_list_networks` | 读取 | 任一 | — | 您的应用在各 Travel Rule 网络中的状态，包括原因、您的参与方记录和尽职调查问卷。 |
| `didit_travel_rule_request_network` | 写入 | 任一 | — | 申请作为参与方加入 Travel Rule 网络。请求会一直等待，直到尽职调查问卷获得批准。 |
| `didit_travel_rule_get_network_questionnaire` | 读取 | 任一 | — | 网络准入的尽职调查问卷：状态、已保存的答案、审核员备注以及状态历史。 |
| `didit_travel_rule_update_network_questionnaire` | 写入 | 任一 | — | 将答案保存到问卷草稿。仅发送需要更改的答案。 |
| `didit_travel_rule_submit_network_questionnaire` | 破坏性操作 | 任一 | — | 提交已保存的问卷以供审核。审核期间无法编辑。 |
| `didit_travel_rule_set_counterparty_vasp` | 写入 | 任一 | — | 为无法路由的出站转账选择交易对手 VASP，并重新向其发起交换。 |
| `didit_travel_rule_list_messages` | 读取 | 任一 | — | 转账中与交易对手 VASP 交换的消息和文件请求，按时间从早到晚排列。 |
| `didit_travel_rule_send_message` | 写入 | 任一 | — | 向转账的交易对手 VASP 发送消息或文件请求。仅与其他 Didit 客户之间的转账，或通过电子邮件进行的转账，才可以携带消息。 |
| `didit_travel_rule_list_counterparty_contacts` | 读取 | 任一 | — | 通过电子邮件联系交易对手 VASP 时使用的合规联系人，包括平台自有联系人和您应用自己的联系人。 |
| `didit_travel_rule_add_counterparty_contact` | 写入 | 任一 | — | 为目录中的 VASP 添加合规联系人，该联系人仅对您的应用可见。 |
| `didit_travel_rule_delete_counterparty_contact` | 破坏性操作 | 任一 | — | 删除您应用自有的一个交易对手联系人。 |
| `didit_travel_rule_get_sandbox_scenarios` | 读取 | 任一 | — | 沙盒应用与之交换的 Didit 测试 VASP，以及每个钱包地址可选择的场景（接受、拒绝、姓名不匹配、无法连接、超时、自托管）。 |
| `didit_travel_rule_trigger_test_inbound` | 写入 | 任一 | — | 仅限沙盒应用：让 Didit 测试 VASP 向您发送一笔入站 Travel Rule 转账。 |

***

## 供应商用户与企业

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_vendor_user_list` | 读取 | `didit:management` | `list:users` | 按 `vendor_data` 分组列出已验证用户。未提供范围时，覆盖所有应用。 |
| `didit_vendor_user_create` | 写入 | `didit:management` | `create:users` | 手动创建一条用户记录。 |
| `didit_vendor_user_get` | 读取 | `didit:management` | `read:users` | 按 `vendor_data` 获取单个用户。 |
| `didit_vendor_user_update` | 写入 | `didit:management` | `write:users` | 更新用户的资料字段。 |
| `didit_vendor_user_update_status` | 写入 | `didit:management` | `write:users` | 将用户状态设置为 `ACTIVE`、`FLAGGED` 或 `BLOCKED`。 |
| `didit_vendor_user_delete` | 破坏性操作 | `didit:management` | `delete:users` | 按 `vendor_data` 批量删除用户，或删除所有用户。 |
| `didit_vendor_business_list` | 读取 | `didit:verification` | `list:businesses` | 按 `vendor_data` 分组列出已验证企业。未提供范围时，覆盖所有应用。 |
| `didit_vendor_business_create` | 写入 | `didit:verification` | `create:businesses` | 手动创建一条企业记录。 |
| `didit_vendor_business_get` | 读取 | `didit:verification` | `read:businesses` | 按 `vendor_data` 获取单个企业。 |
| `didit_vendor_business_update` | 写入 | 任一 | — | 更新企业的资料字段。 |
| `didit_vendor_business_update_status` | 写入 | `didit:verification` | `write:businesses` | 将企业状态设置为 `ACTIVE`、`FLAGGED` 或 `BLOCKED`。 |
| `didit_vendor_business_delete` | 破坏性操作 | `didit:verification` | `delete:businesses` | 按 `vendor_data` 或内部 ID 批量删除企业，或删除所有企业。 |

***

## 名单、黑名单与白名单

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_lists_list` | 读取 | `didit:management` | `read:lists` | 某个应用的全部名单，包括黑名单、白名单和自定义名单。 |
| `didit_lists_create` | 写入 | `didit:management` | `create:lists` | 创建白名单或自定义名单。 |
| `didit_lists_get` | 读取 | `didit:management` | `read:lists` | 按 UUID 获取单个名单。 |
| `didit_lists_update` | 写入 | `didit:management` | `write:lists` | 重命名名单或修改其描述。 |
| `didit_lists_delete` | 破坏性 | `didit:management` | `delete:lists` | 删除名单及其全部条目。 |
| `didit_lists_entries_list` | 读取 | `didit:management` | `read:lists` | 单个名单的条目。 |
| `didit_lists_entry_create` | 写入 | `didit:management` | `create:lists` | 按值或从会话向名单添加条目。 |
| `didit_lists_entry_upload_face` | 写入 | `didit:management` | `create:lists` | 通过图片向人脸名单添加人脸，无需会话。 |
| `didit_lists_entry_delete` | 破坏性 | `didit:management` | `delete:lists` | 从名单中移除一个条目。 |
| `didit_blocklist_get` | 读取 | `didit:verification` | `read:blocklist` | 列出黑名单条目（旧版辅助工具）。 |
| `didit_blocklist_add` | 写入 | `didit:verification` | `write:blocklist` | 向黑名单添加条目（旧版辅助工具）。 |
| `didit_blocklist_remove` | 破坏性 | `didit:verification` | `write:blocklist` | 从黑名单中移除条目（旧版辅助工具）。 |
| `didit_allowlist_add` | 写入 | `didit:verification` | `write:blocklist` | 向白名单添加条目（旧版辅助工具）。 |

***

## 案件

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_case_list` | 读取 | `didit:verification` | `list:cases` | 列出某个应用中的案件。未提供范围时，覆盖所有应用。 |
| `didit_case_get` | 读取 | `didit:verification` | `read:cases` | 获取单个案件及其详情。 |
| `didit_case_create` | 写入 | `didit:verification` | `write:cases` | 创建案件。 |
| `didit_case_statistics` | 读取 | `didit:verification` | `list:cases` | 按状态统计的案件数量及类似统计数据。 |
| `didit_case_manage` | 破坏性 | `didit:verification` | `write:cases` | 分配、解决、重新打开、升级、添加评论或更新案件。 |

***

## 欺诈网络

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_network_list` | 读取 | `didit:verification` | `list:networks` | 列出某个应用中的欺诈网络，并使用控制台的筛选条件和 KPI。 |
| `didit_network_get` | 读取 | `didit:verification` | `read:networks` | 获取单个欺诈网络及其成员和信号；可按需获取图谱、地图和时间线。 |
| `didit_network_membership_get` | 读取 | `didit:verification` | `read:networks` | 会话、企业会话、用户、企业或交易所属的欺诈网络。 |

***

## 调查员

这些工具会出现在每位已登录用户的 `tools/list` 中，但只有在您的组织启用[调查员](https://docs.didit.me/zh/console/investigator.md)后才能使用。

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_investigator_queue_list` | 读取 | 任一 | — | 列出调查员待处理的报告（即审核队列），并显示每项的建议和置信度。 |
| `didit_investigator_report_get` | 读取 | 任一 | — | 获取单份调查员报告：建议、置信度、风险、叙述、证据、先例和问题。 |
| `didit_investigator_record_get` | 读取 | 任一 | — | 调查员对某次验证或某笔交易的最新审核，无论待处理还是已裁定。 |
| `didit_investigator_accept` | 破坏性 | 任一 | — | 接受调查员对某一项的建议；该项将被裁定，并以您的名义记入日志。 |
| `didit_investigator_override` | 破坏性 | 任一 | — | 对某一项做出裁定，使用其他操作、类别和原因，而非采纳建议。 |
| `didit_investigator_batch_accept` | 破坏性 | 任一 | — | 一次接受最多 50 条可执行的建议；无法接受的项目将被跳过，并附上原因。 |
| `didit_investigator_add_note` | 写入 | 任一 | — | 以团队备注的形式添加关于报告中某一项的事实，下一次审核会读取该备注。 |
| `didit_investigator_rereview` | 破坏性 | 任一 | — | 请求调查员重新审核某一项；新报告将替换待处理的旧报告。 |
| `didit_investigator_question_list` | 读取 | 任一 | — | 调查员提出的政策问题，按最新排序。 |
| `didit_investigator_question_get` | 读取 | 任一 | — | 获取单个政策问题，包含团队在该情形下过去 30 天的记录及可选答案。 |
| `didit_investigator_question_answer` | 破坏性 | 任一 | — | 回答政策问题；大多数回答会生成新的政策版本。 |
| `didit_investigator_question_dismiss` | 破坏性 | 任一 | — | 关闭政策问题，不作回答。 |
| `didit_investigator_backtest_start` | 写入 | 任一 | — | 启动免费回测，将当前政策应用于过去 30 或 90 天的决定。回测不做任何裁定。 |
| `didit_investigator_backtest_get` | 读取 | 任一 | — | 已保存的回测结果：按队列、等级和阈值统计的一致率。 |
| `didit_investigator_performance_get` | 读取 | 任一 | — | 过去 7、30 或 90 天内，调查员与您团队的一致率、处理量、节省时间和改判次数。 |
| `didit_investigator_dashboard_get` | 读取 | 任一 | — | 调查员仪表板：30 天自动化率、每周历史、支出和改判次数。 |
| `didit_investigator_activity_list` | 读取 | 任一 | — | 调查员的活动日志，按最新排序：记录智能体和人员的操作。 |

***

## 报告、审计日志和警报

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_report_list` | 读取 | 任一 | — | 列出导出报告。 |
| `didit_report_get` | 读取 | 任一 | — | 单个导出报告的状态和详情。 |
| `didit_report_get_download_url` | 读取 | 任一 | — | 已完成报告的签名下载 URL。 |
| `didit_report_export` | 写入 | 任一 | — | 发起导出（会话、交易、用户或企业）。 |
| `didit_audit_log_list` | 读取 | 任一 | — | 应用的审计日志条目：谁更改了什么。 |
| `didit_alert_list` | 读取 | `didit:management` | `read:applications` | 应用已配置的警报。 |
| `didit_alert_configure` | 写入 | `didit:management` | `write:applications` | 按类型配置一个警报。 |

***

## Webhook

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_webhook_list` | 读取 | `didit:management` | `read:webhooks` | 应用的 Webhook 目标。 |
| `didit_webhook_create` | 写入 | `didit:management` | `write:webhooks` | 创建 Webhook 目标。签名密钥在响应中已脱敏；请从控制台复制。 |
| `didit_webhook_get` | 读取 | `didit:management` | `read:webhooks` | 单个 Webhook 目标，签名密钥已脱敏。 |
| `didit_webhook_update` | 破坏性 | `didit:management` | `write:webhooks` | 更改目标的 URL、版本、启用标志或已订阅事件。 |
| `didit_webhook_delete` | 破坏性 | `didit:management` | `write:webhooks` | 删除一个 Webhook 目标。 |

***

## 市场

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_marketplace_list_catalog` | 读取 | `didit:management` | `read:integrations` | 服务商市场：区块链分析、AML 筛查、电话和银行验证服务商以及 Travel Rule 网络，并列出每项所需的凭据。 |
| `didit_marketplace_list_connections` | 读取 | `didit:management` | `read:integrations` | 你的应用的市场连接和网络成员资格，包含状态和最近使用时间。密钥永远不会返回。 |
| `didit_marketplace_request_integration` | 写入 | `didit:management` | `write:integrations` | 申请尚未开放自助接入的集成；Didit 团队将跟进。 |

***

## 组织、成员、计费与品牌

本组中有两个工具（`didit_org_top_up`、`didit_org_reveal_application_api_key`）已在服务器中定义，但对所有经 OAuth 认证的调用方都从目录中隐藏；它们仅在本地 stdio 服务器上列出。

| 工具 | 类型 | 范围 | 角色权限 | 功能说明 |
| - | - | - | - | - |
| `didit_org_list` | 读取 | 任一 | — | 你所属的组织。 |
| `didit_org_list_applications` | 读取 | 任一 | — | 某个组织的应用。 |
| `didit_org_get_application` | 读取 | 任一 | — | 应用详情，API 密钥已脱敏。 |
| `didit_org_reveal_application_api_key` | 破坏性 | 任一 | — | 返回原始应用 API 密钥。需要明确的 ID 和 `confirm: true`。在托管连接器上隐藏。 |
| `didit_org_get_balance` | 读取 | `didit:management` | `read:subscription` | 额度余额和自动充值设置。 |
| `didit_org_top_up` | 破坏性 | 任一 | — | 创建 Stripe 结账页面以添加额度。在托管连接器上隐藏。 |
| `didit_branding_get` | 读取 | `didit:management` | `read:customization` | 应用于你的验证界面的品牌（徽标、颜色）。 |
| `didit_branding_update` | 写入 | `didit:management` | `write:customization` | 上传新的品牌图片。 |
| `didit_org_list_members` | 读取 | `didit:management` | `list:members` | 某个组织的成员。 |
| `didit_org_invite_member` | 写入 | `didit:management` | `write:members` | 通过邮箱邀请成员并指定角色。 |
| `didit_org_update_member` | 写入 | `didit:management` | `write:members` | 更改成员的角色。 |
| `didit_org_remove_member` | 破坏性 | `didit:management` | `delete:members` | 将成员移出组织。 |
| `didit_org_list_roles` | 读取 | `didit:management` | `list:roles` | 组织中可用的角色。 |
| `didit_org_list_api_keys` | 读取 | `didit:management` | `read:applications` | API 密钥元数据，原始值已脱敏。 |

***

## 文件输入

接收文件的工具（`didit_verify_id`、`didit_verify_poa`、`didit_verify_passive_liveness`、`didit_verify_face_match`、`didit_verify_face_search`、`didit_verify_age`、`didit_lists_entry_upload_face`、`didit_branding_update`）支持以下两种形式之一：

* `*_base64`：文件内容以内联方式提供，可以是原始 base64 或 `data:` URL。对托管端点使用此形式。
* `*_path`：运行服务器的机器上的绝对路径。仅适用于与你共享文件系统的本地 stdio 服务器。

两种形式都强制执行 15 MB 上限和魔术字节白名单（PNG、JPG、WebP、GIF、BMP、ICO、PDF）。托管传输接受最大 25 MB 的 JSON 请求体。

***

> [card] [示例](https://docs.didit.me/zh/integration/mcp/examples.md)
>
> 使用这些工具的完整对话。

> [card] [进阶](https://docs.didit.me/zh/integration/mcp/advanced.md)
>
> 角色、跨应用行为、分支工作流、Webhook、自托管。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.