> ## 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개입니다.
[Investigator 도구](#investigator) 17개도 목록에 포함되지만, 조직에서 Investigator를 활성화해야만 작동합니다.
이 외에 두 개(`didit_org_top_up`, `didit_org_reveal_application_api_key`)는 OAuth로 인증된 카탈로그에서는 모두 숨겨지며 로컬 stdio 서버에서만 나타납니다. 이 서버에는 계정 설정 도구 5개도 추가됩니다([셀프 호스팅](https://docs.didit.me/ko/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`이고, 워크플로, 설문지, 목록, webhook, 연동, 멤버, 역할, API 키, 감사 로그, 조직, 애플리케이션, 구독, 사용자는 `didit:management`입니다. **둘 중 하나**는 두 범위에 모두 포함되는 분석 도구, 또는 역할별 검사가 없어 승인한 범위 중 어느 쪽에서든 실행되는 도구를 뜻합니다. [인증](https://docs.didit.me/ko/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` | ID 문서에서 추출된 데이터를 수정합니다(검토자 수동 재정의). |
| `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 상태, 타이밍, 서명 헤더, 제한된 페이로드 사본. |
| `didit_session_webhook_resend` | 쓰기 | `didit:verification` | `create:sessions` | 세션의 기록된 webhook 전송 하나를 구성된 endpoint로 다시 보냅니다(예: endpoint 수정 후). |

***

## 워크플로

단순 워크플로는 기능 목록을 순서대로 나열한 구조이고, 그래프 워크플로는 분기, 조건, Document AI 단계를 추가합니다. 자세한 내용은 [고급: 분기 워크플로](https://docs.didit.me/ko/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` | 국가별로 제공되는 문서 외 조회 방식과 디지털 ID 지갑, 활성화 여부, 조회 카탈로그 가격을 조회합니다. |
| `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

세션 없이 호출하는 단건 과금 API입니다. 아래 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` | 쓰기 | 둘 중 하나 | — | 클라이언트 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를 선택하고, 해당 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 Test VASP와, 각 지갑 주소가 선택하는 시나리오(수락, 거부, 이름 불일치, 연결 불가, 시간 초과, 자체 보관)를 조회합니다. |
| `didit_travel_rule_trigger_test_inbound` | 쓰기 | 둘 중 하나 | — | 샌드박스 애플리케이션에만 해당합니다. Didit Test VASP가 수신 Travel Rule 전송을 보내도록 합니다. |

***

## Vendor users and businesses

| 도구 | 유형 | 범위 | 역할 권한 | 기능 |
| - | - | - | - | - |
| `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` | 세션, 기업 세션, 사용자, 기업 또는 거래가 속한 사기 네트워크를 조회합니다. |

***

## Investigator

이 도구들은 로그인한 모든 사용자의 `tools/list`에 표시되지만, [Investigator](https://docs.didit.me/ko/console/investigator.md)가 조직에서 활성화되어 있어야 작동합니다.

| 도구 | 유형 | 범위 | 역할 권한 | 기능 |
| - | - | - | - | - |
| `didit_investigator_queue_list` | 읽기 | 둘 중 하나 | — | 검토 대기열에 있는 Investigator의 열린 보고서를 각 항목의 권장 사항 및 신뢰도와 함께 조회합니다. |
| `didit_investigator_report_get` | 읽기 | 둘 중 하나 | — | Investigator 보고서 하나를 조회합니다. 권장 사항, 신뢰도, 위험, 서술, 증거, 선례, 질문이 포함됩니다. |
| `didit_investigator_record_get` | 읽기 | 둘 중 하나 | — | 인증 또는 거래 하나에 대한 Investigator의 가장 최근 검토를 조회합니다. 열린 상태든 결정된 상태든 상관없습니다. |
| `didit_investigator_accept` | 파괴적 작업 | 둘 중 하나 | — | 항목 하나에 대한 Investigator의 권장 사항을 수락합니다. 항목은 결정되고 귀하의 이름으로 기록됩니다. |
| `didit_investigator_override` | 파괴적 작업 | 둘 중 하나 | — | 권장 사항 대신 다른 작업, 범주, 사유를 지정해 항목 하나를 결정합니다. |
| `didit_investigator_batch_accept` | 파괴적 작업 | 둘 중 하나 | — | 준비된 권장 사항을 한 번에 최대 50개까지 수락합니다. 수락할 수 없는 항목은 사유와 함께 건너뜁니다. |
| `didit_investigator_add_note` | 쓰기 | 둘 중 하나 | — | 보고서 항목에 대한 사실을 다음 검토에서 읽을 팀 메모로 추가합니다. |
| `didit_investigator_rereview` | 파괴적 작업 | 둘 중 하나 | — | 항목을 다시 검토하도록 Investigator에 요청합니다. 새 보고서가 열린 보고서를 대체합니다. |
| `didit_investigator_question_list` | 읽기 | 둘 중 하나 | — | Investigator가 제기한 정책 질문을 최신순으로 조회합니다. |
| `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일 동안 Investigator와 팀의 일치율, 처리량, 절약된 시간, 재정의 건수를 조회합니다. |
| `didit_investigator_dashboard_get` | 읽기 | 둘 중 하나 | — | Investigator 대시보드를 조회합니다. 30일 자동화, 주간 기록, 비용, 재정의가 포함됩니다. |
| `didit_investigator_activity_list` | 읽기 | 둘 중 하나 | — | Investigator의 활동 로그를 최신순으로 조회합니다. 에이전트와 사람이 수행한 작업이 포함됩니다. |

***

## 보고서, 감사 로그 및 알림

| 도구 | 유형 | 범위 | 역할 권한 | 기능 |
| - | - | - | - | - |
| `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` | 인증 UI에 적용된 브랜딩(로고, 색상)입니다. |
| `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 형식으로 전달합니다. 호스팅 endpoint에 사용합니다.
* `*_path`: 서버를 실행하는 기기의 절대 경로입니다. 사용자와 파일 시스템을 공유하는 로컬 stdio 서버에서만 작동합니다.

두 형식 모두 15MB 상한과 매직 바이트 허용 목록(PNG, JPG, WebP, GIF, BMP, ICO, PDF)을 적용합니다. 호스팅 전송은 최대 25MB의 JSON 본문을 허용합니다.

***

> [card] [예제](https://docs.didit.me/ko/integration/mcp/examples.md)
>
> 이 도구를 사용하는 대화를 처음부터 끝까지 보여줍니다.

> [card] [고급](https://docs.didit.me/ko/integration/mcp/advanced.md)
>
> 역할, 앱 간 동작, 분기 워크플로, webhook, 자체 호스팅.


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