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.

• 110+ tools across sessions, workflows, vendor users/businesses, transactions, the standalone verification APIs, lists, cases, reports, webhooks, and billing.

• Two ways to run it: a hosted server with "Log in with Didit" (OAuth 2.1 + PKCE, no API key), or a local stdio server authenticated with an application API key.

• Every tool calls a single Didit REST endpoint and returns the JSON verbatim.

Full documentation: https://docs.didit.me/integration/mcp/overview

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

Claude Code

claude mcp add --transport http didit https://mcp.didit.me/mcp

Cursor (~/.cursor/mcp.json)

{ "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 Claude Desktop and VS Code.

Local (stdio + API key)

{
  "mcpServers": {
    "didit": {
      "command": "npx",
      "args": ["@didit-protocol/mcp-server"],
      "env": { "DIDIT_API_KEY": "your_api_key_here" }
    }
  }
}

Get DIDIT_API_KEY from the Business Console → Settings → API Keys, or have the agent register an account for you (didit_account_register → didit_account_verify_email).

Related MCP server: Nexus-MCP

Authentication

Scopes: didit:management (workspace operations) and didit:verification (running checks). Your console role is enforced server-side on every call. See Authentication.

Tools

110+ tools, grouped by area. 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.

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

• Compliance: transaction monitoring, lists/blocklist/allowlist, cases, reports, audit logs, alerts.

• Workspace: questionnaires, webhooks, members, billing, branding.

Run it yourself

npm install
npm run build

# Local stdio (API key)
DIDIT_API_KEY=... node dist/index.js

# Hosted HTTP/OAuth
node dist/http.js   # serves /mcp and /healthz on $MCP_PORT (default 3000)

All Didit base URLs and OAuth endpoints are environment variables with public defaults (verification.didit.me, apx.didit.me, business.didit.me) — override them for a private deployment. See ARCHITECTURE.md and .env.example for the full reference.

Contributing

Issues and PRs welcome — see CONTRIBUTING.md. This repo is the public source for the @didit-protocol/mcp-server npm package.

License

MIT © Didit Protocol