Didit MCP server
2026년 11월 15일 커밋통합 검증 도구를 통해 AI agent가 KYC, KYB, AML 스크리닝, 트랜잭션 모니터링 및 사기 방지 워크플로우를 수행할 수 있도록 지원합니다.
다른 이름 didit-protocol/mcp, mcp
- 스타
- 1
- Tools
- 9
- 다운로드, 30일
- —
- 최신 버전
- 5.0.1
- 마지막 커밋
- 2026년 11월 15일
- 라이선스
- MIT
Didit MCP란?
통합 검증 도구를 통해 AI agent가 KYC, KYB, AML 스크리닝, 트랜잭션 모니터링 및 사기 방지 워크플로우를 수행할 수 있도록 지원합니다. 9개 도구를 제공합니다. 예: npx, amount_in_dollars, confirm.
프로젝트 README에서 생성된 요약
Didit MCP server 정보
Didit MCP server는 AI agent에게 신원 확인 및 컴플라이언스 워크플로우 관리 기능을 제공합니다. KYC, KYB, AML 스크리닝, 트랜잭션 모니터링 및 생체 인식 검증을 수행하기 위한 160개 이상의 도구를 통합했습니다. 개발자는 Claude, Cursor, VS Code, Windsurf, Zed와 같은 클라이언트와 이 server를 함께 사용하여 복잡한 검증 프로세스를 자동화할 수 있습니다.
사용자는 개인 계정 액세스를 위해 OAuth 2.1을 사용하는 호스트 URL로 연결하거나, CI/CD 환경의 헤드리스 agent를 위해 애플리케이션 API key를 제공하여 연결할 수 있습니다. 토큰 사용량을 관리하기 위해 server는 약 30개의 도구를 포함하는 core toolset을 제공하며, 전체 카탈로그는 검색 도구를 통해 접근할 수 있습니다. 보안이 중요한 환경을 위해 agent 상호작용 중 상태 변경을 방지하는 읽기 전용 모드를 사용할 수 있습니다.
활용 사례
- 1신원 검증 워크플로우 자동화AI agent가 샌드박스 환경 내에서 검증 세션을 생성하고 관리하여 컴플라이언스 로직을 테스트할 수 있습니다.
- 2토큰 소비 최적화세션 중 토큰 비용을 줄이기 위해 AI 컨텍스트에 로드되는 도구 수를 제한할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Didit MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Didit MCP 설치
$ claude mcp add --transport http mcp https://mcp.didit.me/mcpCursor에 Didit MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.didit.me/mcp"
}
}
}VS Code에 Didit MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.didit.me/mcp"
}
}
}VS Code CLI에 Didit MCP 설치
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.didit.me/mcp"}'Codex에 Didit MCP 설치
$ codex mcp add mcp --url https://mcp.didit.me/mcpCodex config.toml에 Didit MCP 설치
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.didit.me/mcp"
Gemini CLI에 Didit MCP 설치
$ gemini mcp add -s user --transport http mcp https://mcp.didit.me/mcpGemini settings.json에 Didit MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.didit.me/mcp",
"type": "http"
}
}
}Didit MCP 도구 9
README에서 감지됨npxamount_in_dollarsconfirmpayment_methodidempotency_keyagent_top_up_not_enabledauthentication_requiredpayment_method_requiredcard_declined
| npx | — | |
| amount_in_dollars | — | |
| confirm | — | |
| payment_method | — | |
| idempotency_key | — | |
| agent_top_up_not_enabled | — | |
| authentication_required | — | |
| payment_method_required | — | |
| card_declined | — |
구성
DIDIT_ACCESS_TOKEN
| 이름 | 설명 | 유형 |
|---|---|---|
| DIDIT_ACCESS_TOKEN | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능didit-protocol/mcp is public and reachablegithub.com/didit-protocol/mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/didit-protocol/mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음9 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기Didit MCP Server
The official Model Context Protocol server for Didit — bring KYC, KYB, AML screening, transaction monitoring, biometrics, and full workspace operations to Claude, Cursor, VS Code, Windsurf, Zed, and any MCP client.
- 160+ tools across sessions, workflows, vendor users/businesses, transactions, the standalone verification APIs, lists, cases, reports, webhooks, and billing.
- Load only what you need. Add
?toolsets=corefor a short catalog of about 30 tools, about a tenth of the tokens the full list costs; the rest stays one step away throughdidit_tool_search. See Toolsets. - Read-only mode for connections that must never change anything: add
?read_only=true. - Two ways to connect. "Log in with Didit" (OAuth 2.1 + PKCE): the MCP acts as the signed-in user with their role's permissions. Or an application API key, for agents that run with no person present (CI, scheduled jobs, backend agents): the connection is that one application. See Authentication.
- Tools call Didit REST endpoints. Session PDF generation returns a temporary download URL for the original PDF.
Full documentation: https://docs.didit.me/integration/mcp/overview
Session PDF downloads
didit_session_generate_pdf returns download_url, expires_at (UTC), and
expires_in (300 seconds). Fetch the URL without an Authorization header to save
the original Didit PDF. The server checks PDF access before issuing the link and
fetches the original report again at download time using the same user and organization.
It does not reconstruct the report from session data. If the session changes between
issuance and download, the download reflects the current report. Revoked or expired
user access can invalidate a link before its five-minute expiry.
Deployments must set MCP_PDF_DOWNLOAD_KEY to 32 cryptographically random bytes
encoded as 64 hexadecimal characters, shared across all replicas, and set
MCP_RESOURCE_URI to the public HTTPS MCP endpoint. Route
/downloads/session-report.pdf to this HTTP server. The authenticated-encryption
key protects the credentials embedded in the session-scoped link; rotating it
invalidates outstanding links. Treat links as secrets and redact the token query
parameter in proxy/access logs. Responses use Cache-Control: no-store.
E-signature files
didit_session_get_signature_evidence, didit_session_get_signed_document and
didit_session_get_signature_field_image return the same kind of link (plus content_type)
for a signer's evidence PDF, the signed PDF of one document and the PNG of a signature field.
They use the same MCP_PDF_DOWNLOAD_KEY and MCP_RESOURCE_URI; route
/downloads/session-signature to this HTTP server as well. The file is checked against its
recorded SHA-256 at issuance and again at download. didit_session_validate_signatures
re-validates the signed documents and returns the result as JSON.
Stdio deployments need a reachable HTTP deployment with the same key, API base URL,
and MCP_RESOURCE_URI; stdio alone cannot serve download links. Missing key
configuration produces an actionable tool error instead of inline PDF data.
Quick start
Hosted (recommended)
No install, no API key — point your client at the hosted URL and sign in via the browser:
https://mcp.didit.me/mcp
| Client | Install |
|---|---|
| Claude (web, Desktop) | Add Didit to Claude |
| Claude Code | claude mcp add --transport http didit https://mcp.didit.me/mcp |
| Cursor | Add Didit to Cursor |
| VS Code (GitHub Copilot) | Add Didit to VS Code |
| OpenAI Codex | codex mcp add didit --url https://mcp.didit.me/mcp |
Cursor (~/.cursor/mcp.json), by hand
{ "mcpServers": { "didit": { "url": "https://mcp.didit.me/mcp" } } }
Windsurf / Zed (via the mcp-remote bridge)
{ "mcpServers": { "didit": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"] } } }
See per-client setup for every client, with screenshots and troubleshooting.
Once connected, ask for "my Didit context" (the model calls didit_context_get), or start from one of the server's prompts: integrate_didit, review_queue, explain_session, build_workflow, verification_report.
Sign in without a browser (device code)
For the local (stdio) server on a remote machine, in a container or in CI, where no browser can open, sign in with an OAuth device code. It also works for accounts that use a passkey or SSO and have no password.
npx -y @didit-protocol/mcp-server login
The terminal prints a short code and a link:
To connect this machine to your Didit account, open https://business.didit.me/device and enter the code WDJB-MJHT
Or open: https://business.didit.me/device?user_code=WDJB-MJHT
Approve only if the code on the page matches this one.
Open the link on any device with a browser, sign in to Didit, check that the code matches and approve. The command then saves your credentials and prints the scopes that were granted (never the token). Approve only a code you started yourself.
- Credentials live in
~/.config/didit/mcp-credentials.json(override withDIDIT_MCP_CREDENTIALS_FILE), readable by you only, one entry per Didit environment. - The local server uses them automatically when
DIDIT_ACCESS_TOKENis not set, and refreshes them before they expire. npx -y @didit-protocol/mcp-server logoutrevokes the grant and deletes the stored credentials.- Set
DIDIT_DEVICE_NAMEto change the name shown on the approval page (default: the machine's hostname). - In CI, run
loginonce on a trusted machine and mount the credentials file as a secret, or setDIDIT_ACCESS_TOKENas before. Do not share one credentials file between jobs that run at the same time, because refresh tokens rotate. - No shell? Ask the agent to call
didit_account_device_login_start, show you the link and code, thendidit_account_device_login_pollonce you approve. Both tools exist only on the local server.
Sign in with the account tools
On the local server an agent can also sign in by itself, with an email address and a password: didit_account_login for an existing account (then didit_account_verify_2fa when the account has an authenticator app), or didit_account_register and didit_account_verify_email for a new one.
The local server keeps that sign-in, so the tools that follow are authenticated with nothing passed between them.
- It is kept in the same credentials file as a device-code sign-in (
~/.config/didit/mcp-credentials.json, readable by you only) and refreshed before it expires. A server started later picks it up. - The answer of these tools carries no refresh token: the server holds it, because a refresh token works once.
- When the file cannot be written (a read-only home directory in a container), the sign-in is kept in memory until the server stops.
- If you signed in both ways, the server uses the more recent sign-in.
DIDIT_ACCESS_TOKEN, when set, still takes precedence over both. npx -y @didit-protocol/mcp-server logoutremoves it from the machine.- An account that signs in with a passkey or SSO has no password: use the device code above.
These tools exist only on the local server. The hosted server never takes a password.
Connect with an API key (headless agents and CI)
An agent that runs with no person present has no browser to sign in with.
It connects to the hosted server with the application API key it already sends to the Didit API, in the x-api-key header:
Claude Code
claude mcp add --transport http didit https://mcp.didit.me/mcp --header "x-api-key: $DIDIT_API_KEY"
Cursor (~/.cursor/mcp.json)
{ "mcpServers": { "didit": { "url": "https://mcp.didit.me/mcp", "headers": { "x-api-key": "${env:DIDIT_API_KEY}" } } } }
Any other client or your own agent: send x-api-key: <key> on every request to https://mcp.didit.me/mcp.
Authorization: Bearer <key> works too, for clients that only let you set a bearer token.
What an API key connection is:
- One application.
The connection acts on the application the key belongs to, so there are no ids to pass.
didit_context_getnames it, says whether it isliveorsandbox, and reportsconnection.type: "api_key". A call that names another organization or application is refused. - The key's own access. The key is forwarded to the Didit API exactly as on a direct API call, and the API decides what it may do. A full-access key reaches everything of its application; a restricted key only the resources it was given. Give an agent a restricted key with an expiry, created in the Didit console under the application's API keys.
- Sandbox first. Connect with the sandbox application's key to build and test: every check is simulated and nothing is billed.
- Combines with toolsets and read-only:
https://mcp.didit.me/mcp?toolsets=core&read_only=true(see Toolsets). - Revoked like any key. Revoke or rotate the key in the console and the connection stops within a minute. Every tool call is logged with the key's id, never the key.
What needs a person, and is therefore neither listed nor run on an API key connection:
- members, roles and API key management;
- the organization's plan, cards, receipts and billing details;
- the audit log, and
didit_workflow_build_graph(usedidit_workflow_create, or the graph toolsdidit_workflow_create_draft,didit_workflow_validate_graphanddidit_workflow_set_graph); - download links for session PDFs and e-signature files (request the file from the Didit API with the same key).
A person does those in the Didit console, or through a connection that signs in with OAuth.
Two limits to know:
- A key limited to specific IP addresses is refused, because the Didit API would see this server's address and not yours.
/mcpand/mcp/paymentstake a key. From nothing to a first verification, with no browser. The account tools of the local server create the account:didit_account_register, thendidit_account_verify_emailwith the code sent to the email address. The answer carries the new organization with its live and its sandbox application, each with its API key. The local server is signed in from that moment (see Sign in with the account tools), so the same conversation goes on to create a workflow (didit_workflow_create) and a session (didit_session_create) in the sandbox application. For an agent that runs elsewhere, store the keys in your secret store and connect it to the hosted server with the sandbox key; switch to the live key to go live.didit_org_get_balancereads the credit balance; when credit is needed, see Agent payments.
GET /healthz lists api_key under features on a server that accepts keys.
Authentication
The MCP is an OAuth 2.1 resource server; the Didit console (business.didit.me) is the authorization server. On first connect your client opens a browser, you Log in with Didit and approve the scopes, and the MCP then acts as you — across every organization you belong to, with your role's permissions. Tokens are short-lived and refreshed automatically.
Scopes: didit:management (workspace operations), didit:verification (running checks) and didit:staff (Didit staff accounts only; the authorization server never issues it to anyone else). Your console role is enforced server-side on every call.
The hosted server also takes an application API key in place of a sign-in, for agents that run with no person present. Such a connection is one application with the key's own access, not a user with a role: see Connect with an API key.
The phone code pair,
didit_verify_phone_sendanddidit_verify_phone_check, always calls the public phone API with the application's API key, because the console has no route for them. On a sign-in the MCP reads that key with your sign-in (a role withcreate:sessionsand thedidit:managementscope, or an organization owner or admin for a localdidit_account_logintoken); on an API key connection it uses the connection's own key. The key is never returned, stored or logged.
See Authentication.
Toolsets
By default a connection lists every tool your role may use, as it always has. Tool definitions are sent to the model with every request, so the whole catalog costs tens of thousands of tokens each time: roughly 50,000 to 115,000, depending on the model's tokenizer. Some clients also cap how many tools they accept. The short catalog trades that cost for one more step, a search for the tool: measured on a set of everyday requests, the strongest models reached the right tool a little more often with the full list, at about ten times the tokens. When the cost matters (a coding agent with a context budget, a client that caps the number of tools), name the toolsets you want on the server URL:
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?toolsets=core,workflows
https://mcp.didit.me/mcp?toolsets=core,transactions,cases&read_only=true
core is the short catalog: about 30 tools and about a tenth of the tokens.
It covers your organizations and applications, sessions (create, find, decide, explain, simulate in the sandbox, webhook deliveries), finding workflows, analytics and balance, the application's API key and webhooks, finding cases, users, businesses and transactions, and the documentation search.
| Toolset | What it holds |
|---|---|
core |
The short list above. |
account |
Organizations, applications, API keys, members and roles. |
billing |
Plan, credit balance, payment methods, receipts and billing details. |
sessions |
Verification sessions: create, find, decide, review, share, import, PDFs and webhook deliveries. |
workflows |
Verification workflows and questionnaires: build, edit, validate and publish. |
lists |
Custom lists, the blocklist and the allowlist. |
vendors |
The people and companies you verify: vendor users and vendor businesses. |
transactions |
Transaction monitoring: transactions, wallet screening and rules with backtesting. |
cases |
Case management: create, assign, escalate and resolve cases. |
investigator |
The AI Investigator: its review queue, reports, decisions, policy questions and performance. |
webhooks |
Webhook destinations and alerts. |
reports |
Analytics, exports and the audit log. |
branding |
White-label branding of the verification flow. |
verification |
Standalone verification APIs: ID document, face, AML, proof of address, phone, email, database and business checks. |
docs |
Search the Didit documentation. |
all |
Every tool your role may use. The default. |
How it behaves:
- Toolsets are opt-in. A URL with no
toolsetslists everything, so an existing connection sees no difference. - Naming toolsets lists exactly those.
?toolsets=caseslists the case tools (anddidit_context_get); addcoreto get the short list too. - A toolset decides what is listed, not what you may run. A tool outside the selection still runs when called by name, with the same permission checks as always. Nothing is lost by loading less.
- The rest stays one step away. When a connection lists only part of the catalog it also gets four discovery tools:
didit_tool_search(find a tool by what you want to do, or list a toolset),didit_tool_describe(its full schema),didit_tool_call_readanddidit_tool_call_write(run it). A call through them is checked exactly like a direct call. read_only=trueis a safety boundary. Only tools that read are listed or discoverable, and every call that would change data is refused, whatever the client lists or remembers. It works with or withouttoolsets.- An unknown toolset is ignored, never an error, and the server's instructions name it back with the valid ids.
- Clients that cannot edit the URL send the
X-MCP-ToolsetsandX-MCP-Readonlyheaders instead. - The local (stdio) server takes
--toolsets=core,workflowsand--read-only, or theDIDIT_TOOLSETSandDIDIT_READ_ONLYenvironment variables. - A self-hosted server can change what a connection gets when it names nothing with
MCP_DEFAULT_TOOLSETS(for examplecore). GET /healthzlists what the server supports ("features": ["toolsets", "read_only", ...]), for a client that wants to check before it relies on one.
The server also sends instructions on connect (where to start, how organization and application ids resolve, what this connection loaded) and offers prompts (integrate_didit, review_queue, explain_session, build_workflow, verification_report).
didit_docs_search searches the live documentation at docs.didit.me, so questions about how Didit works are answered from the current pages; set DIDIT_DOCS_MCP_URL to an empty string to switch it off.
Tools
160+ tools, grouped by toolset. The full catalogue with read/write/destructive markers is in docs/TOOLS.md and at docs.didit.me. Highlights:
- Discovery & cross-app:
didit_context_get,didit_session_search,didit_transaction_search,didit_vendor_user_search,didit_analytics— aggregate across every org/app in one call. - Sessions: create, list, get decision, update status, reviews, bulk import, webhook delivery log + resend (
didit_session_webhookswaits for a sandbox session's webhook so an integration can be verified end to end), Precise Location evidence (didit_session_get_location_evidence: every attempt and the same person's earlier checks behind a Location verdict). - Verification APIs:
didit_verify_id,didit_verify_aml,didit_verify_face_match,didit_verify_kyb_search, … - Workflows (incl. branching graphs):
didit_workflow_search,didit_workflow_get_graph,didit_workflow_edit_graph— build conditional/branching workflows (fuzzy-match conditions, Document-AI steps) by sending small ops; large feature configs are kept server-side, never resent.didit_workflow_get_id_verification_methods_cataloganddidit_workflow_get_kyb_registry_cataloganswer the server-driven questions a config write depends on (which countries offer non-doc lookup / wallets, which KYB data tiers and monitoring a country's registries sell). - Investigator (AI case reviewer):
didit_investigator_queue_list,didit_investigator_report_get(recommendation, basis, evidence, precedents),didit_investigator_record_get(the review of one verification or transaction, open or decided),didit_investigator_add_note(a fact the user adds, as a team note the next review reads), questions, the free backtest (didit_investigator_backtest_start), performance, dashboard and Activity. Its decisions (didit_investigator_accept,_override,_batch_accept), policy answers (_question_answer,_question_dismiss) and the re-review that replaces the open report (_rereview, optionally with a note) are annotated destructive and refused withoutconfirm: true, which a client sends only after the user approves that exact action. Every Investigator call sendsX-Didit-Actor-Via: mcp(orcopilotwhen the console assistant marks its request so), so the Investigator Activity shows where the user acted from. - Compliance: transaction monitoring, custom and preset rule management with backtesting, lists/blocklist/allowlist, cases, reports, audit logs, alerts.
- Workspace: questionnaires, webhooks, members, billing, branding.
- API key for your integration:
didit_org_create_api_keycreates ONE key per connected app and application, scoped to what the signed-in person can do (never full access or key management), rate-limited and audit-logged. The secret is returned once; the person sees the key with the connected app in the console and can revoke it there. - Billing:
didit_org_get_balance,didit_billing_get_plan,didit_billing_quote_plan,didit_billing_list_payment_methods,didit_billing_list_receipts,didit_billing_get_detailsanddidit_billing_update_details. No tool charges a card: when credit or a plan change is needed, the tools return console links (next_steps.top_up_urlopens the top-up dialog with the amount filled in) and the person pays there. The local stdio server and the unlisted/mcp/paymentsendpoint (below) also offerdidit_org_top_up.
Didit MCP 질문
Didit MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http mcp https://mcp.didit.me/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Didit MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Didit MCP는 어떤 도구를 제공하나요?
9개 도구를 제공합니다. 예: npx, amount_in_dollars, confirm, payment_method, idempotency_key.
토큰을 절약하기 위해 로드되는 도구 수를 제한할 수 있나요?
네, 연결 URL에 '?toolsets=core'를 추가하면 약 30개의 필수 도구로 구성된 축소된 카탈로그를 로드할 수 있습니다.
agent가 데이터를 수정하지 못하도록 보장하는 방법이 있나요?
네, 연결 URL에 '?read_only=true'를 추가하여 읽기 전용 모드를 사용할 수 있습니다.
로컬 배포 환경에서 PDF 다운로드는 어떻게 처리하나요?
로컬 배포 시 MCP_PDF_DOWNLOAD_KEY와 MCP_RESOURCE_URI를 설정해야 하며, 파일을 제공할 수 있도록 특정 경로를 HTTP server로 라우팅해야 합니다.