@didit-protocol/mcp-server 3.0.3 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/README.md +70 -22
  2. package/dist/config.d.ts +25 -0
  3. package/dist/config.d.ts.map +1 -1
  4. package/dist/config.js +65 -0
  5. package/dist/config.js.map +1 -1
  6. package/dist/index.js +769 -96
  7. package/dist/index.js.map +1 -1
  8. package/dist/tools/auth.d.ts +2 -0
  9. package/dist/tools/auth.d.ts.map +1 -1
  10. package/dist/tools/auth.js +33 -16
  11. package/dist/tools/auth.js.map +1 -1
  12. package/dist/tools/billing.d.ts.map +1 -1
  13. package/dist/tools/billing.js +3 -10
  14. package/dist/tools/billing.js.map +1 -1
  15. package/dist/tools/businesses.d.ts +7 -0
  16. package/dist/tools/businesses.d.ts.map +1 -0
  17. package/dist/tools/businesses.js +35 -0
  18. package/dist/tools/businesses.js.map +1 -0
  19. package/dist/tools/customization.d.ts +12 -0
  20. package/dist/tools/customization.d.ts.map +1 -0
  21. package/dist/tools/customization.js +25 -0
  22. package/dist/tools/customization.js.map +1 -0
  23. package/dist/tools/lists.d.ts +3 -0
  24. package/dist/tools/lists.d.ts.map +1 -1
  25. package/dist/tools/lists.js +28 -26
  26. package/dist/tools/lists.js.map +1 -1
  27. package/dist/tools/questionnaires.d.ts.map +1 -1
  28. package/dist/tools/questionnaires.js +5 -25
  29. package/dist/tools/questionnaires.js.map +1 -1
  30. package/dist/tools/sessions.d.ts +7 -1
  31. package/dist/tools/sessions.d.ts.map +1 -1
  32. package/dist/tools/sessions.js +38 -61
  33. package/dist/tools/sessions.js.map +1 -1
  34. package/dist/tools/settings.d.ts.map +1 -1
  35. package/dist/tools/settings.js +5 -23
  36. package/dist/tools/settings.js.map +1 -1
  37. package/dist/tools/standalone.d.ts +8 -6
  38. package/dist/tools/standalone.d.ts.map +1 -1
  39. package/dist/tools/standalone.js +32 -102
  40. package/dist/tools/standalone.js.map +1 -1
  41. package/dist/tools/transactions.d.ts +5 -0
  42. package/dist/tools/transactions.d.ts.map +1 -0
  43. package/dist/tools/transactions.js +20 -0
  44. package/dist/tools/transactions.js.map +1 -0
  45. package/dist/tools/users.d.ts +2 -0
  46. package/dist/tools/users.d.ts.map +1 -1
  47. package/dist/tools/users.js +13 -21
  48. package/dist/tools/users.js.map +1 -1
  49. package/dist/tools/webhooks.d.ts +6 -0
  50. package/dist/tools/webhooks.d.ts.map +1 -0
  51. package/dist/tools/webhooks.js +24 -0
  52. package/dist/tools/webhooks.js.map +1 -0
  53. package/package.json +1 -1
  54. package/dist/tools/blocklist.d.ts +0 -4
  55. package/dist/tools/blocklist.d.ts.map +0 -1
  56. package/dist/tools/blocklist.js +0 -30
  57. package/dist/tools/blocklist.js.map +0 -1
package/dist/index.js CHANGED
@@ -42,11 +42,51 @@ const sessions = __importStar(require("./tools/sessions"));
42
42
  const settings = __importStar(require("./tools/settings"));
43
43
  const billing = __importStar(require("./tools/billing"));
44
44
  const users = __importStar(require("./tools/users"));
45
+ const businesses = __importStar(require("./tools/businesses"));
46
+ const transactions = __importStar(require("./tools/transactions"));
47
+ const customization = __importStar(require("./tools/customization"));
48
+ const webhooks = __importStar(require("./tools/webhooks"));
45
49
  const questionnaires = __importStar(require("./tools/questionnaires"));
46
50
  const lists = __importStar(require("./tools/lists"));
47
51
  const standalone = __importStar(require("./tools/standalone"));
48
- const config_1 = require("./config");
49
- const server = new index_js_1.Server({ name: "didit", version: "3.0.0" }, { capabilities: { tools: {} } });
52
+ // Single source of truth for the version: package.json (falls back if unreadable).
53
+ let SERVER_VERSION = "4.0.0";
54
+ try {
55
+ // eslint-disable-next-line @typescript-eslint/no-var-requires
56
+ SERVER_VERSION = require("../package.json").version || SERVER_VERSION;
57
+ }
58
+ catch {
59
+ /* keep fallback */
60
+ }
61
+ const SESSION_STATUSES = "Not Started, In Progress, In Review, Approved, Declined, Expired, Abandoned, Kyc Expired, Resubmitted, Awaiting User";
62
+ const LANGUAGE_CODES = [
63
+ "en", "ar", "bg", "bn", "bs", "ca", "cnr", "cs", "da", "de", "el", "es", "et",
64
+ "fa", "fi", "fr", "he", "hi", "hr", "hu", "hy", "id", "it", "ja", "ka", "kk",
65
+ "ko", "ky", "lt", "lv", "mk", "mn", "ms", "nl", "no", "pl", "pt-BR", "pt",
66
+ "ro", "ru", "sk", "sl", "so", "sq", "sr", "sv", "th", "tr", "uk", "uz",
67
+ "vi", "zh-CN", "zh-TW", "zh",
68
+ ];
69
+ const DOCUMENT_TYPES = ["P", "DL", "ID", "RP", "SSC", "HIC", "WP", "TC", "VISA", "PSC", "BC", "OTHER"];
70
+ const ENTITY_STATUSES = ["ACTIVE", "FLAGGED", "BLOCKED"];
71
+ const LIST_ENTRY_TYPES = [
72
+ "face", "document", "phone", "email", "ip_address", "device_fingerprint",
73
+ "wallet_address", "bank_account", "user", "business", "country", "key",
74
+ ];
75
+ const WORKFLOW_FEATURES = [
76
+ "OCR", "NFC", "LIVENESS", "FACE_MATCH", "PROOF_OF_ADDRESS", "QUESTIONNAIRE",
77
+ "PHONE_VERIFICATION", "EMAIL_VERIFICATION", "DATABASE_VALIDATION", "AML",
78
+ "IP_ANALYSIS", "AGE_ESTIMATION", "KYB_REGISTRY", "KYB_DOCUMENTS", "KYB_KEY_PEOPLE",
79
+ ];
80
+ const WORKFLOW_FEATURE_ITEM = {
81
+ type: "object",
82
+ properties: {
83
+ feature: { type: "string", enum: WORKFLOW_FEATURES, description: "Feature to run (uppercase)" },
84
+ config: { type: "object", description: "Feature-specific settings (e.g. face_liveness_method, questionnaire_uuid, documents_allowed)" },
85
+ label: { type: "string", description: "Optional internal node label" },
86
+ },
87
+ required: ["feature"],
88
+ };
89
+ const server = new index_js_1.Server({ name: "didit", version: SERVER_VERSION }, { capabilities: { tools: {} } });
50
90
  // ---------------------------------------------------------------------------
51
91
  // Tool definitions
52
92
  // ---------------------------------------------------------------------------
@@ -77,6 +117,17 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
77
117
  required: ["email", "code"],
78
118
  },
79
119
  },
120
+ {
121
+ name: "didit_resend_otp",
122
+ description: "Resend the 6-character email verification code for a pending registration. Codes expire after 10 minutes.",
123
+ inputSchema: {
124
+ type: "object",
125
+ properties: {
126
+ email: { type: "string", description: "Email address the code was originally sent to" },
127
+ },
128
+ required: ["email"],
129
+ },
130
+ },
80
131
  {
81
132
  name: "didit_login",
82
133
  description: "Login to existing Didit account. Returns access_token and refresh_token.",
@@ -100,6 +151,18 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
100
151
  required: ["access_token"],
101
152
  },
102
153
  },
154
+ {
155
+ name: "didit_list_applications",
156
+ description: "List all applications in an organization. Each application has its own client_id and api_key. Requires access_token.",
157
+ inputSchema: {
158
+ type: "object",
159
+ properties: {
160
+ access_token: { type: "string", description: "Bearer access token" },
161
+ organization_id: { type: "string" },
162
+ },
163
+ required: ["access_token", "organization_id"],
164
+ },
165
+ },
103
166
  {
104
167
  name: "didit_get_application",
105
168
  description: "Get application details including client_id and api_key. Requires access_token.",
@@ -116,25 +179,37 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
116
179
  // ── Sessions ────────────────────────────────────────────────────────
117
180
  {
118
181
  name: "didit_create_session",
119
- description: "Create a new identity verification session. Returns session_id, session_url, and session_token.",
182
+ description: "Create a verification session. Requires workflow_id (created in the Console Workflows page) — the workflow defines which steps run and whether the session is KYC or KYB. Returns session_id, url, and session_token.",
120
183
  inputSchema: {
121
184
  type: "object",
122
185
  properties: {
123
- callback_url: { type: "string", description: "URL to redirect user after verification" },
124
- vendor_data: { type: "string", description: "Your unique identifier for the user (e.g. user ID)" },
125
- features: { type: "string", description: "Comma-separated features: ocr,face,liveness,aml,phone,email,poa,questionnaire" },
186
+ workflow_id: { type: "string", description: "REQUIRED. UUID of the workflow that defines the verification steps. Selects KYC vs KYB implicitly." },
187
+ vendor_data: { type: "string", description: "Your unique identifier for the user (e.g. user ID). Used to group sessions into a user/business." },
188
+ callback: { type: "string", description: "URL to redirect the user to after verification" },
189
+ callback_method: { type: "string", enum: ["initiator", "completer", "both"], description: "Which device/flow the callback applies to" },
190
+ language: { type: "string", enum: LANGUAGE_CODES, description: "Pre-set the verification UI language (ISO code)" },
191
+ metadata: { type: "object", description: "Arbitrary JSON stored on the session and echoed in webhooks" },
192
+ contact_details: { type: "object", description: "Pre-fill contact info (e.g. email, phone) for the session" },
193
+ expected_details: { type: "object", description: "Expected values to validate against (e.g. expected country, IP)" },
194
+ portrait_image: { type: "string", description: "Base64 or URL reference portrait used by some workflows" },
126
195
  },
196
+ required: ["workflow_id"],
127
197
  },
128
198
  },
129
199
  {
130
200
  name: "didit_list_sessions",
131
- description: "List verification sessions with optional filters and pagination.",
201
+ description: `List verification sessions with filters and pagination. status accepts session-level values: ${SESSION_STATUSES}.`,
132
202
  inputSchema: {
133
203
  type: "object",
134
204
  properties: {
135
- status: { type: "string", description: "Filter by status: Approved, Declined, In Review, Pending" },
205
+ status: { type: "string", description: `Filter by session status (${SESSION_STATUSES})` },
206
+ session_kind: { type: "string", enum: ["user", "business", "all"], description: "KYC (user), KYB (business), or all" },
136
207
  vendor_data: { type: "string", description: "Filter by vendor_data" },
137
- limit: { type: "string", description: "Number of results per page" },
208
+ workflow_id: { type: "string", description: "Filter by workflow UUID" },
209
+ search: { type: "string", description: "Free-text search" },
210
+ date_from: { type: "string", description: "ISO date lower bound" },
211
+ date_to: { type: "string", description: "ISO date upper bound" },
212
+ limit: { type: "string", description: "Page size (LimitOffset pagination)" },
138
213
  offset: { type: "string", description: "Pagination offset" },
139
214
  },
140
215
  },
@@ -152,14 +227,67 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
152
227
  },
153
228
  {
154
229
  name: "didit_update_session_status",
155
- description: "Approve, decline, or request resubmission of a session. Resubmitted sessions keep already-approved steps.",
230
+ description: "Approve, decline, or request resubmission of a session. For resubmission, pass new_status='Resubmitted' and nodes_to_resubmit; already-approved steps are kept.",
231
+ inputSchema: {
232
+ type: "object",
233
+ properties: {
234
+ session_id: { type: "string" },
235
+ new_status: { type: "string", enum: ["Approved", "Declined", "Resubmitted"], description: "New decision status" },
236
+ comment: { type: "string", description: "Reviewer note stored on the audit trail" },
237
+ nodes_to_resubmit: { type: "array", items: { type: "string" }, description: "Node IDs the user must redo (only for Resubmitted)" },
238
+ send_email: { type: "boolean", description: "Email the user about the status change" },
239
+ email_address: { type: "string", description: "Override the recipient email" },
240
+ email_language: { type: "string", description: "Language for the notification email" },
241
+ },
242
+ required: ["session_id", "new_status"],
243
+ },
244
+ },
245
+ {
246
+ name: "didit_update_session_data",
247
+ description: "Correct the KYC data extracted from the ID document on a session (reviewer override). Only send the fields you want to change.",
248
+ inputSchema: {
249
+ type: "object",
250
+ properties: {
251
+ session_id: { type: "string" },
252
+ document_type: { type: "string", enum: DOCUMENT_TYPES },
253
+ document_subtype: { type: "string" },
254
+ document_number: { type: "string" },
255
+ personal_number: { type: "string" },
256
+ date_of_birth: { type: "string", description: "YYYY-MM-DD" },
257
+ date_of_issue: { type: "string", description: "YYYY-MM-DD" },
258
+ expiration_date: { type: "string", description: "YYYY-MM-DD" },
259
+ issuing_state: { type: "string", description: "ISO 3166-1 alpha-3 issuing country" },
260
+ first_name: { type: "string" },
261
+ last_name: { type: "string" },
262
+ gender: { type: "string", enum: ["M", "F", "U"] },
263
+ address: { type: "string" },
264
+ place_of_birth: { type: "string" },
265
+ nationality: { type: "string" },
266
+ marital_status: { type: "string", enum: ["SINGLE", "MARRIED", "DIVORCED", "WIDOWED", "UNKNOWN"] },
267
+ extra_fields: { type: "object", description: "Document-specific extra fields" },
268
+ parsed_address: { type: "object", description: "Structured address override" },
269
+ },
270
+ required: ["session_id"],
271
+ },
272
+ },
273
+ {
274
+ name: "didit_update_session_poa_data",
275
+ description: "Correct the Proof of Address data extracted from the POA document on a session (reviewer override). Only send the fields you want to change.",
156
276
  inputSchema: {
157
277
  type: "object",
158
278
  properties: {
159
279
  session_id: { type: "string" },
160
- status: { type: "string", description: "New status: Approved, Declined, Resubmission Requested" },
280
+ issuing_state: { type: "string", description: "ISO 3166-1 alpha-3 issuing country" },
281
+ document_type: { type: "string", enum: ["UTILITY_BILL", "BANK_STATEMENT", "GOVERNMENT_ISSUED_DOCUMENT", "OTHER_POA_DOCUMENT", "UNKNOWN"] },
282
+ document_language: { type: "string" },
283
+ issuer: { type: "string" },
284
+ issue_date: { type: "string", description: "YYYY-MM-DD" },
285
+ poa_address: { type: "string" },
286
+ name_on_document: { type: "string" },
287
+ extra_fields: { type: "object" },
288
+ poa_parsed_address: { type: "object", description: "Structured address override" },
161
289
  },
162
- required: ["session_id", "status"],
290
+ required: ["session_id"],
163
291
  },
164
292
  },
165
293
  {
@@ -212,13 +340,17 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
212
340
  },
213
341
  {
214
342
  name: "didit_add_session_review",
215
- description: "Add a review note or status change to a session.",
343
+ description: "Add a review note to a session's audit trail, optionally changing its status.",
216
344
  inputSchema: {
217
345
  type: "object",
218
346
  properties: {
219
347
  session_id: { type: "string" },
220
348
  comment: { type: "string", description: "Review comment or note" },
221
- status: { type: "string", description: "Optional new status" },
349
+ new_status: {
350
+ type: "string",
351
+ enum: ["Not Started", "In Progress", "Approved", "Declined", "In Review", "Expired", "Abandoned", "Kyc Expired", "Resubmitted", "Awaiting User"],
352
+ description: "Optional new session status to record with the note",
353
+ },
222
354
  },
223
355
  required: ["session_id"],
224
356
  },
@@ -246,6 +378,48 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
246
378
  required: ["share_token"],
247
379
  },
248
380
  },
381
+ // ── Session Imports (bulk migration) ────────────────────────────────
382
+ {
383
+ name: "didit_create_import",
384
+ description: "Create a bulk import job from a hosted CSV/NDJSON file (e.g. migrating historical verifications into Didit). Pass source_file_url. All imports use Didit's canonical schema. To label a record's source, include the optional per-row `provider` column in the file itself (defaults to generic) — there is no provider request field.",
385
+ inputSchema: {
386
+ type: "object",
387
+ properties: {
388
+ source_file_url: { type: "string", description: "REQUIRED. Publicly fetchable URL of the CSV/NDJSON file to import." },
389
+ import_type: { type: "string", enum: ["user_verification", "business_verification", "status_rules", "transactions"], description: "What the rows represent (default user_verification)" },
390
+ source_format: { type: "string", enum: ["csv", "ndjson"], description: "File format (default csv)" },
391
+ workflow_id: { type: "string", description: "Workflow to associate imported sessions with" },
392
+ },
393
+ required: ["source_file_url"],
394
+ },
395
+ },
396
+ {
397
+ name: "didit_get_import_template",
398
+ description: "Download the canonical import template (column headers and format) used by didit_create_import.",
399
+ inputSchema: { type: "object", properties: {} },
400
+ },
401
+ {
402
+ name: "didit_get_import",
403
+ description: "Get the status and summary of a bulk import job.",
404
+ inputSchema: {
405
+ type: "object",
406
+ properties: {
407
+ import_id: { type: "string", description: "Import job ID returned by didit_create_import" },
408
+ },
409
+ required: ["import_id"],
410
+ },
411
+ },
412
+ {
413
+ name: "didit_get_import_errors",
414
+ description: "List per-row errors for a bulk import job (rows that failed validation or processing).",
415
+ inputSchema: {
416
+ type: "object",
417
+ properties: {
418
+ import_id: { type: "string", description: "Import job ID" },
419
+ },
420
+ required: ["import_id"],
421
+ },
422
+ },
249
423
  // ── Workflows (Verification Settings) ───────────────────────────────
250
424
  {
251
425
  name: "didit_list_workflows",
@@ -254,22 +428,26 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
254
428
  },
255
429
  {
256
430
  name: "didit_create_workflow",
257
- description: "Create a new verification workflow. Enable features like OCR (ID scan), face match, liveness detection, AML screening, phone, email, proof of address, and questionnaire.",
431
+ description: "Create a verification workflow from an ordered list of features. Send `features` (uppercase feature values, in execution order) — NOT flat is_*_enabled flags or a workflow_type (those are rejected with 400). Put dependency features first (e.g. OCR before FACE_MATCH/NFC/DATABASE_VALIDATION). KYB workflows use KYB_REGISTRY/KYB_DOCUMENTS/KYB_KEY_PEOPLE.",
258
432
  inputSchema: {
259
433
  type: "object",
260
434
  properties: {
261
- workflow_label: { type: "string", description: "Name for the workflow" },
435
+ workflow_label: { type: "string", description: "Display name (max 50 chars)" },
436
+ features: {
437
+ type: "array",
438
+ minItems: 1,
439
+ items: WORKFLOW_FEATURE_ITEM,
440
+ description: "Verification features in execution order. Each: { feature, config?, label? }. Example: [{\"feature\":\"OCR\"},{\"feature\":\"LIVENESS\",\"config\":{\"face_liveness_method\":\"PASSIVE\"}},{\"feature\":\"FACE_MATCH\"}]",
441
+ },
262
442
  is_default: { type: "boolean", description: "Set as default workflow for new sessions" },
263
- is_ocr_enabled: { type: "boolean", description: "Enable ID document scanning" },
264
- is_face_match_enabled: { type: "boolean", description: "Enable face match against ID photo" },
265
- is_liveness_enabled: { type: "boolean", description: "Enable anti-spoofing liveness detection" },
266
- is_aml_enabled: { type: "boolean", description: "Enable AML/sanctions screening" },
267
- is_phone_verification_enabled: { type: "boolean", description: "Enable phone number verification" },
268
- is_email_verification_enabled: { type: "boolean", description: "Enable email verification" },
269
- is_poa_enabled: { type: "boolean", description: "Enable proof of address" },
270
- is_questionnaire_enabled: { type: "boolean", description: "Enable custom questionnaire" },
443
+ status: { type: "string", enum: ["draft", "published"], description: "Omit to publish immediately; 'draft' saves without publishing" },
444
+ is_white_label_enabled: { type: "boolean" },
445
+ is_desktop_allowed: { type: "boolean" },
446
+ max_retry_attempts: { type: "number" },
447
+ retry_window_days: { type: "number" },
448
+ session_expiration_time: { type: "number" },
271
449
  },
272
- required: ["workflow_label"],
450
+ required: ["features"],
273
451
  },
274
452
  },
275
453
  {
@@ -285,21 +463,24 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
285
463
  },
286
464
  {
287
465
  name: "didit_update_workflow",
288
- description: "Update a workflow's configuration (feature toggles, thresholds, accepted documents, etc.).",
466
+ description: "Update a workflow. Send only the fields to change. To change steps, send the full replacement `features` array (same shape as create). Editing features retroactively affects how past sessions' decisions are read, so change deliberately.",
289
467
  inputSchema: {
290
468
  type: "object",
291
469
  properties: {
292
470
  workflow_id: { type: "string", description: "Workflow UUID" },
293
471
  workflow_label: { type: "string" },
472
+ features: {
473
+ type: "array",
474
+ items: WORKFLOW_FEATURE_ITEM,
475
+ description: "Replacement feature list in execution order (same shape as create)",
476
+ },
294
477
  is_default: { type: "boolean" },
295
- is_ocr_enabled: { type: "boolean" },
296
- is_face_match_enabled: { type: "boolean" },
297
- is_liveness_enabled: { type: "boolean" },
298
- is_aml_enabled: { type: "boolean" },
299
- is_phone_verification_enabled: { type: "boolean" },
300
- is_email_verification_enabled: { type: "boolean" },
301
- is_poa_enabled: { type: "boolean" },
302
- is_questionnaire_enabled: { type: "boolean" },
478
+ status: { type: "string", enum: ["draft", "published"] },
479
+ is_white_label_enabled: { type: "boolean" },
480
+ is_desktop_allowed: { type: "boolean" },
481
+ max_retry_attempts: { type: "number" },
482
+ retry_window_days: { type: "number" },
483
+ session_expiration_time: { type: "number" },
303
484
  },
304
485
  required: ["workflow_id"],
305
486
  },
@@ -373,19 +554,37 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
373
554
  required: ["questionnaire_id"],
374
555
  },
375
556
  },
376
- // ── Users ───────────────────────────────────────────────────────────
557
+ // ── Users (verified individuals / KYC) ──────────────────────────────
377
558
  {
378
559
  name: "didit_list_users",
379
- description: "List all verified users. Supports pagination and status filtering.",
560
+ description: "List verified users (grouped by vendor_data). Supports limit/offset pagination.",
380
561
  inputSchema: {
381
562
  type: "object",
382
563
  properties: {
383
- status: { type: "string", description: "Filter: Approved, Declined, In Review, Pending" },
384
564
  limit: { type: "string" },
385
565
  offset: { type: "string" },
386
566
  },
387
567
  },
388
568
  },
569
+ {
570
+ name: "didit_create_user",
571
+ description: "Create a user record manually (e.g. to pre-register a vendor_data identity or attach allowlisted emails/phones).",
572
+ inputSchema: {
573
+ type: "object",
574
+ properties: {
575
+ vendor_data: { type: "string", description: "REQUIRED. Your unique identifier for the user" },
576
+ full_name: { type: "string" },
577
+ display_name: { type: "string" },
578
+ date_of_birth: { type: "string", description: "YYYY-MM-DD" },
579
+ status: { type: "string", enum: ENTITY_STATUSES },
580
+ metadata: { type: "object" },
581
+ approved_emails: { type: "array", items: { type: "string" } },
582
+ approved_phones: { type: "array", items: { type: "string" } },
583
+ issuing_states: { type: "array", items: { type: "string" } },
584
+ },
585
+ required: ["vendor_data"],
586
+ },
587
+ },
389
588
  {
390
589
  name: "didit_get_user",
391
590
  description: "Get details of a specific user by their vendor_data identifier.",
@@ -399,16 +598,35 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
399
598
  },
400
599
  {
401
600
  name: "didit_update_user",
402
- description: "Update user metadata or tags.",
601
+ description: "Update a user's profile fields. Only send the fields you want to change. To change ONLY the monitoring status, prefer didit_update_user_status.",
403
602
  inputSchema: {
404
603
  type: "object",
405
604
  properties: {
406
605
  vendor_data: { type: "string", description: "The vendor_data value that identifies the user" },
407
- tags: { type: "array", items: { type: "string" }, description: "Tags to assign" },
606
+ full_name: { type: "string" },
607
+ display_name: { type: "string" },
608
+ date_of_birth: { type: "string", description: "YYYY-MM-DD" },
609
+ status: { type: "string", enum: ENTITY_STATUSES, description: "Monitoring status" },
610
+ metadata: { type: "object" },
611
+ approved_emails: { type: "array", items: { type: "string" } },
612
+ approved_phones: { type: "array", items: { type: "string" } },
613
+ issuing_states: { type: "array", items: { type: "string" } },
408
614
  },
409
615
  required: ["vendor_data"],
410
616
  },
411
617
  },
618
+ {
619
+ name: "didit_update_user_status",
620
+ description: "Set a user's monitoring status (ACTIVE, FLAGGED, or BLOCKED).",
621
+ inputSchema: {
622
+ type: "object",
623
+ properties: {
624
+ vendor_data: { type: "string", description: "The vendor_data value that identifies the user" },
625
+ status: { type: "string", enum: ENTITY_STATUSES, description: "New status" },
626
+ },
627
+ required: ["vendor_data", "status"],
628
+ },
629
+ },
412
630
  {
413
631
  name: "didit_delete_users",
414
632
  description: "Batch delete users by vendor_data list, or delete all users.",
@@ -424,6 +642,155 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
424
642
  },
425
643
  },
426
644
  },
645
+ // ── Businesses (KYB) ────────────────────────────────────────────────
646
+ {
647
+ name: "didit_list_businesses",
648
+ description: "List verified businesses (KYB, grouped by vendor_data). Supports limit/offset pagination.",
649
+ inputSchema: {
650
+ type: "object",
651
+ properties: {
652
+ limit: { type: "string" },
653
+ offset: { type: "string" },
654
+ },
655
+ },
656
+ },
657
+ {
658
+ name: "didit_create_business",
659
+ description: "Create a business record manually (KYB).",
660
+ inputSchema: {
661
+ type: "object",
662
+ properties: {
663
+ vendor_data: { type: "string", description: "Your unique identifier for the business" },
664
+ display_name: { type: "string" },
665
+ legal_name: { type: "string" },
666
+ registration_number: { type: "string" },
667
+ country_code: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
668
+ status: { type: "string", enum: ENTITY_STATUSES },
669
+ metadata: { type: "object" },
670
+ },
671
+ },
672
+ },
673
+ {
674
+ name: "didit_get_business",
675
+ description: "Get details of a specific business by its vendor_data identifier.",
676
+ inputSchema: {
677
+ type: "object",
678
+ properties: {
679
+ vendor_data: { type: "string", description: "The vendor_data value that identifies the business" },
680
+ },
681
+ required: ["vendor_data"],
682
+ },
683
+ },
684
+ {
685
+ name: "didit_update_business",
686
+ description: "Update a business's profile fields. Only send the fields you want to change.",
687
+ inputSchema: {
688
+ type: "object",
689
+ properties: {
690
+ vendor_data: { type: "string" },
691
+ display_name: { type: "string" },
692
+ legal_name: { type: "string" },
693
+ registration_number: { type: "string" },
694
+ country_code: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
695
+ status: { type: "string", enum: ENTITY_STATUSES },
696
+ metadata: { type: "object" },
697
+ },
698
+ required: ["vendor_data"],
699
+ },
700
+ },
701
+ {
702
+ name: "didit_update_business_status",
703
+ description: "Set a business's monitoring status (ACTIVE, FLAGGED, or BLOCKED).",
704
+ inputSchema: {
705
+ type: "object",
706
+ properties: {
707
+ vendor_data: { type: "string" },
708
+ status: { type: "string", enum: ENTITY_STATUSES, description: "New status" },
709
+ },
710
+ required: ["vendor_data", "status"],
711
+ },
712
+ },
713
+ {
714
+ name: "didit_delete_businesses",
715
+ description: "Batch delete businesses by vendor_data list and/or didit_internal_id list, or delete all businesses.",
716
+ inputSchema: {
717
+ type: "object",
718
+ properties: {
719
+ vendor_data_list: { type: "array", items: { type: "string" } },
720
+ didit_internal_id_list: { type: "array", items: { type: "string" } },
721
+ delete_all: { type: "boolean", description: "Set true to delete ALL businesses" },
722
+ },
723
+ },
724
+ },
725
+ // ── Transactions (AML transaction monitoring) ───────────────────────
726
+ {
727
+ name: "didit_list_transactions",
728
+ description: "List monitored transactions. Supports limit/offset pagination.",
729
+ inputSchema: {
730
+ type: "object",
731
+ properties: {
732
+ limit: { type: "string" },
733
+ offset: { type: "string" },
734
+ },
735
+ },
736
+ },
737
+ {
738
+ name: "didit_create_transaction",
739
+ description: "Submit a transaction for monitoring and rule evaluation. transaction_details and subject shapes depend on transaction_category.",
740
+ inputSchema: {
741
+ type: "object",
742
+ properties: {
743
+ transaction_id: { type: "string", description: "REQUIRED. Your unique transaction identifier" },
744
+ transaction_category: {
745
+ type: "string",
746
+ enum: ["finance", "kyc", "travel_rule", "user_event", "audit_trail_event", "gambling_bet", "gambling_limit_change", "gambling_bonus_change"],
747
+ description: "REQUIRED. Determines the expected transaction_details/subject shape",
748
+ },
749
+ transaction_details: { type: "object", description: "REQUIRED. Category-specific transaction payload" },
750
+ subject: { type: "object", description: "REQUIRED. The party initiating the transaction (usually a vendor_data reference)" },
751
+ counterparty: { type: "object", description: "The other party in the transaction" },
752
+ transaction_at: { type: "string", description: "ISO timestamp of the transaction" },
753
+ time_zone: { type: "string" },
754
+ custom_properties: { type: "object", description: "Custom values keyed for monitoring rules (custom_values.<key>)" },
755
+ travel_rule_details: { type: "object" },
756
+ network_snapshot: { type: "object" },
757
+ include_crypto_screening: { type: "boolean" },
758
+ },
759
+ required: ["transaction_id", "transaction_category", "transaction_details", "subject"],
760
+ },
761
+ },
762
+ {
763
+ name: "didit_get_transaction",
764
+ description: "Get a single monitored transaction and its rule-evaluation result.",
765
+ inputSchema: {
766
+ type: "object",
767
+ properties: {
768
+ transaction_id: { type: "string", description: "Transaction ID" },
769
+ },
770
+ required: ["transaction_id"],
771
+ },
772
+ },
773
+ {
774
+ name: "didit_screen_wallet",
775
+ description: "Screen a single crypto wallet address for AML risk WITHOUT creating a transaction. Returns risk_score, severity, sanctions_hit, source/destination of funds. Requires transaction monitoring to be configured (a provider key) or returns 409.",
776
+ inputSchema: {
777
+ type: "object",
778
+ properties: {
779
+ wallet_address: { type: "string", description: "REQUIRED. The crypto address to screen (must match the chain's address format)" },
780
+ blockchain: {
781
+ type: "string",
782
+ enum: ["BTC", "ETH", "LTC", "XRP", "BCH", "DOGE", "TRX", "SOL", "MATIC", "BNB", "USDT", "USDC"],
783
+ description: "REQUIRED. Asset / chain identifier",
784
+ },
785
+ direction: {
786
+ type: "string",
787
+ enum: ["inbound", "outbound", "deposit", "withdrawal"],
788
+ description: "Optional screening direction context",
789
+ },
790
+ },
791
+ required: ["wallet_address", "blockchain"],
792
+ },
793
+ },
427
794
  // ── Billing ─────────────────────────────────────────────────────────
428
795
  {
429
796
  name: "didit_get_balance",
@@ -437,26 +804,87 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
437
804
  type: "object",
438
805
  properties: {
439
806
  amount_in_dollars: { type: "number", description: "Amount in USD (minimum $50)" },
807
+ success_url: { type: "string", description: "Optional redirect after successful payment" },
808
+ cancel_url: { type: "string", description: "Optional redirect if payment is cancelled" },
440
809
  },
441
810
  required: ["amount_in_dollars"],
442
811
  },
443
812
  },
444
- // ── Webhook ────────────────────────────────────────────────────────
813
+ // ── Customization (verification UI branding) ────────────────────────
814
+ {
815
+ name: "didit_get_customization",
816
+ description: "Get the current branding customization (logos, colors) applied to your verification UI.",
817
+ inputSchema: { type: "object", properties: {} },
818
+ },
819
+ {
820
+ name: "didit_update_customization",
821
+ description: "Update verification UI branding images. Provide absolute file paths for the images you want to set.",
822
+ inputSchema: {
823
+ type: "object",
824
+ properties: {
825
+ image_square_path: { type: "string", description: "Absolute path to a square logo image" },
826
+ image_rectangular_path: { type: "string", description: "Absolute path to a rectangular logo image" },
827
+ image_favicon_path: { type: "string", description: "Absolute path to a favicon image" },
828
+ },
829
+ },
830
+ },
831
+ // ── Webhook destinations ────────────────────────────────────────────
445
832
  {
446
- name: "didit_get_webhook",
447
- description: "Get current webhook configuration including URL, version, and secret key for verifying signatures.",
833
+ name: "didit_list_webhook_destinations",
834
+ description: "List configured webhook destinations. Each destination has its own URL, version, enabled flag, subscribed events, and signing secret.",
448
835
  inputSchema: { type: "object", properties: {} },
449
836
  },
450
837
  {
451
- name: "didit_update_webhook",
452
- description: "Update webhook URL, version, or rotate the secret key. Set rotate_secret_key=true to get a new webhook secret.",
838
+ name: "didit_create_webhook_destination",
839
+ description: "Create a webhook destination. The response includes the signing secret used to verify the X-Signature header on delivered events.",
840
+ inputSchema: {
841
+ type: "object",
842
+ properties: {
843
+ label: { type: "string", description: "REQUIRED. Human-readable name" },
844
+ url: { type: "string", description: "REQUIRED. HTTPS endpoint to receive events" },
845
+ enabled: { type: "boolean", description: "Whether the destination receives events (default true)" },
846
+ webhook_version: { type: "string", enum: ["v1", "v2", "v3"], description: "Payload version (v3 recommended)" },
847
+ subscribed_events: { type: "array", items: { type: "string" }, description: "Event types to deliver (e.g. status.updated, data.updated, user.created). Omit to receive all." },
848
+ },
849
+ required: ["label", "url"],
850
+ },
851
+ },
852
+ {
853
+ name: "didit_get_webhook_destination",
854
+ description: "Get a single webhook destination, including its signing secret.",
855
+ inputSchema: {
856
+ type: "object",
857
+ properties: {
858
+ destination_uuid: { type: "string", description: "Webhook destination UUID" },
859
+ },
860
+ required: ["destination_uuid"],
861
+ },
862
+ },
863
+ {
864
+ name: "didit_update_webhook_destination",
865
+ description: "Update a webhook destination's URL, version, enabled flag, or subscribed events.",
866
+ inputSchema: {
867
+ type: "object",
868
+ properties: {
869
+ destination_uuid: { type: "string", description: "Webhook destination UUID" },
870
+ label: { type: "string" },
871
+ url: { type: "string" },
872
+ enabled: { type: "boolean" },
873
+ webhook_version: { type: "string", enum: ["v1", "v2", "v3"] },
874
+ subscribed_events: { type: "array", items: { type: "string" } },
875
+ },
876
+ required: ["destination_uuid"],
877
+ },
878
+ },
879
+ {
880
+ name: "didit_delete_webhook_destination",
881
+ description: "Delete a webhook destination so it stops receiving events.",
453
882
  inputSchema: {
454
883
  type: "object",
455
884
  properties: {
456
- webhook_url: { type: "string", description: "URL to receive webhooks. Set to null to disable." },
457
- webhook_version: { type: "string", description: "Payload version: v1, v2, or v3 (recommended)" },
458
- rotate_secret_key: { type: "boolean", description: "Set true to generate new webhook secret" },
885
+ destination_uuid: { type: "string", description: "Webhook destination UUID" },
459
886
  },
887
+ required: ["destination_uuid"],
460
888
  },
461
889
  },
462
890
  // ── Lists (Blocklists, Allowlists & Custom) ─────────────────────────
@@ -467,12 +895,61 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
467
895
  type: "object",
468
896
  properties: {
469
897
  list_type: { type: "string", description: "Filter: blocklist, allowlist, custom" },
470
- entry_type: { type: "string", description: "Filter: face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, user, business, country, key" },
898
+ entry_type: { type: "string", description: `Filter: ${LIST_ENTRY_TYPES.join(", ")}` },
471
899
  limit: { type: "string" },
472
900
  offset: { type: "string" },
473
901
  },
474
902
  },
475
903
  },
904
+ {
905
+ name: "didit_create_list",
906
+ description: "Create an allowlist or custom list. System blocklists are auto-provisioned (one per entry type) and cannot be created. name must be unique per application.",
907
+ inputSchema: {
908
+ type: "object",
909
+ properties: {
910
+ name: { type: "string", description: "REQUIRED. Unique list name" },
911
+ list_type: { type: "string", enum: ["allowlist", "custom"], description: "REQUIRED. allowlist or custom (blocklists are auto-provisioned)" },
912
+ entry_type: { type: "string", enum: LIST_ENTRY_TYPES, description: "REQUIRED. What kind of values the list holds" },
913
+ description: { type: "string" },
914
+ },
915
+ required: ["name", "list_type", "entry_type"],
916
+ },
917
+ },
918
+ {
919
+ name: "didit_get_list",
920
+ description: "Get a single list's details by UUID.",
921
+ inputSchema: {
922
+ type: "object",
923
+ properties: {
924
+ list_uuid: { type: "string", description: "UUID of the list" },
925
+ },
926
+ required: ["list_uuid"],
927
+ },
928
+ },
929
+ {
930
+ name: "didit_update_list",
931
+ description: "Rename or update the description of an allowlist/custom list. System blocklists are immutable.",
932
+ inputSchema: {
933
+ type: "object",
934
+ properties: {
935
+ list_uuid: { type: "string", description: "UUID of the list" },
936
+ name: { type: "string" },
937
+ description: { type: "string" },
938
+ },
939
+ required: ["list_uuid"],
940
+ },
941
+ },
942
+ {
943
+ name: "didit_delete_list",
944
+ description: "Delete an allowlist/custom list and all its entries. System blocklists cannot be deleted.",
945
+ inputSchema: {
946
+ type: "object",
947
+ properties: {
948
+ list_uuid: { type: "string", description: "UUID of the list" },
949
+ },
950
+ required: ["list_uuid"],
951
+ },
952
+ },
476
953
  {
477
954
  name: "didit_list_entries",
478
955
  description: "List entries in a specific list. Use search to filter by value or label.",
@@ -489,12 +966,12 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
489
966
  },
490
967
  {
491
968
  name: "didit_create_list_entry",
492
- description: "Add an entry to a blocklist/allowlist/custom list. Pass value directly, or reference_session_id to auto-extract from a session (face, document, phone, email, IP, device). Pass both to disambiguate when a session has multiple values of the same type. Use reference_object_uuid for traceability to transactions/users/businesses.",
969
+ description: "Add an entry to a blocklist/allowlist/custom list. Pass value directly, or reference_session_id to auto-extract from a session (face, document, phone, email, IP, device). Pass both to disambiguate when a session has multiple values of the same type. For face entries without a session, use didit_upload_face_entry instead.",
493
970
  inputSchema: {
494
971
  type: "object",
495
972
  properties: {
496
973
  list_uuid: { type: "string", description: "UUID of the list to add to" },
497
- value: { type: "string", description: "Value to blocklist (phone, email, IP, etc.). Optional if reference_session_id is provided." },
974
+ value: { type: "string", description: "Value to add (phone, email, IP, etc.). Optional if reference_session_id is provided." },
498
975
  reference_session_id: { type: "string", description: "Session UUID — backend auto-extracts the value based on the list's entry type" },
499
976
  reference_object_uuid: { type: "string", description: "UUID of the source entity (transaction, vendor user/business) for traceability" },
500
977
  display_label: { type: "string", description: "Human-readable label" },
@@ -504,6 +981,20 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
504
981
  required: ["list_uuid"],
505
982
  },
506
983
  },
984
+ {
985
+ name: "didit_upload_face_entry",
986
+ description: "Add a face entry to a face list by uploading an image directly (no session needed). Use this when you have a photo but no reference_session_id.",
987
+ inputSchema: {
988
+ type: "object",
989
+ properties: {
990
+ list_uuid: { type: "string", description: "UUID of a face-type list" },
991
+ image_path: { type: "string", description: "Absolute path to the face image file" },
992
+ display_label: { type: "string" },
993
+ comment: { type: "string" },
994
+ },
995
+ required: ["list_uuid", "image_path"],
996
+ },
997
+ },
507
998
  {
508
999
  name: "didit_delete_list_entry",
509
1000
  description: "Remove an entry from a list. Also unblocks the underlying user/business if applicable.",
@@ -525,35 +1016,87 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
525
1016
  properties: {
526
1017
  front_image_path: { type: "string", description: "Absolute path to front image file" },
527
1018
  back_image_path: { type: "string", description: "Absolute path to back image file (optional)" },
1019
+ vendor_data: { type: "string", description: "Optional identifier to link the result to a user" },
1020
+ perform_document_liveness: { type: "boolean", description: "Run document-presence (anti-screenshot) checks" },
1021
+ minimum_age: { type: "number", description: "Decline if the extracted age is below this value" },
1022
+ preferred_characters: { type: "string", enum: ["latin", "non_latin"], description: "Preferred OCR script" },
528
1023
  },
529
1024
  required: ["front_image_path"],
530
1025
  },
531
1026
  },
532
1027
  {
533
1028
  name: "didit_poa_verification",
534
- description: "Proof of Address verification. Submit document images to extract and validate address information.",
1029
+ description: "Proof of Address verification. Submit a single document image to extract and validate address information.",
535
1030
  inputSchema: {
536
1031
  type: "object",
537
1032
  properties: {
538
- front_image_path: { type: "string", description: "Absolute path to front image file" },
539
- back_image_path: { type: "string", description: "Absolute path to back image file (optional)" },
1033
+ document_image_path: { type: "string", description: "Absolute path to the POA document image" },
1034
+ vendor_data: { type: "string", description: "Optional identifier to link the result to a user" },
1035
+ expected_address: { type: "string", description: "Address to validate the document against" },
1036
+ expected_country: { type: "string", description: "ISO 3166-1 alpha-2 country code to validate against" },
1037
+ expected_first_name: { type: "string" },
1038
+ expected_last_name: { type: "string" },
540
1039
  },
541
- required: ["front_image_path"],
1040
+ required: ["document_image_path"],
542
1041
  },
543
1042
  },
544
1043
  {
545
1044
  name: "didit_database_validation",
546
- description: "Validate identity data against national and global authoritative data sources.",
1045
+ description: "Validate identity data against national and global authoritative data sources. issuing_state (ISO 3166-1 alpha-2) is required and selects which sources run.",
547
1046
  inputSchema: {
548
1047
  type: "object",
549
1048
  properties: {
1049
+ issuing_state: { type: "string", description: "REQUIRED. ISO 3166-1 alpha-2 country code that selects the data sources to query" },
550
1050
  first_name: { type: "string" },
551
1051
  last_name: { type: "string" },
552
- date_of_birth: { type: "string", description: "YYYY-MM-DD format" },
1052
+ middle_name: { type: "string" },
1053
+ full_name: { type: "string" },
1054
+ date_of_birth: { type: "string", description: "YYYY-MM-DD" },
553
1055
  document_number: { type: "string" },
554
- country: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
1056
+ document_type: { type: "string", enum: DOCUMENT_TYPES },
1057
+ personal_number: { type: "string" },
1058
+ tax_number: { type: "string" },
1059
+ gender: { type: "string", enum: ["M", "F", "X"] },
1060
+ nationality: { type: "string" },
1061
+ services: { type: "array", items: { type: "string" }, description: "Optional service_ids to restrict which sources run" },
1062
+ partial_match_action: { type: "string", enum: ["DECLINE", "NO_ACTION"] },
1063
+ no_match_action: { type: "string", enum: ["DECLINE", "NO_ACTION"] },
1064
+ vendor_data: { type: "string" },
1065
+ metadata: { type: "object" },
1066
+ },
1067
+ required: ["issuing_state"],
1068
+ },
1069
+ },
1070
+ // ── Standalone: KYB registry ────────────────────────────────────────
1071
+ {
1072
+ name: "didit_kyb_search",
1073
+ description: "Search official company registries for a business by name and/or registration number. Returns candidate matches; pass a candidate's kyb_response_id to didit_kyb_select to pull the full record.",
1074
+ inputSchema: {
1075
+ type: "object",
1076
+ properties: {
1077
+ country_code: { type: "string", description: "REQUIRED. ISO 3166-1 alpha-2 country code" },
1078
+ name: { type: "string", description: "Company name to search" },
1079
+ registration_number: { type: "string", description: "Registration number to search" },
1080
+ search_type: { type: "string", enum: ["contains", "start_with", "fuzzy"], description: "Name match strategy" },
1081
+ vendor_data: { type: "string" },
1082
+ metadata: { type: "object" },
1083
+ webhook_url: { type: "string", description: "Optional URL notified when the registry result resolves" },
1084
+ },
1085
+ required: ["country_code"],
1086
+ },
1087
+ },
1088
+ {
1089
+ name: "didit_kyb_select",
1090
+ description: "Resolve a candidate from didit_kyb_search into a full company registry record. kyb_response_id is the per-search candidate handle returned by the search.",
1091
+ inputSchema: {
1092
+ type: "object",
1093
+ properties: {
1094
+ kyb_response_id: { type: "string", description: "REQUIRED. Candidate handle from didit_kyb_search" },
1095
+ vendor_data: { type: "string" },
1096
+ metadata: { type: "object" },
1097
+ save_api_request: { type: "boolean" },
555
1098
  },
556
- required: ["first_name", "last_name", "date_of_birth", "country"],
1099
+ required: ["kyb_response_id"],
557
1100
  },
558
1101
  },
559
1102
  // ── Standalone: Biometrics & Face ───────────────────────────────────
@@ -564,18 +1107,20 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
564
1107
  type: "object",
565
1108
  properties: {
566
1109
  image_path: { type: "string", description: "Absolute path to facial image file" },
1110
+ vendor_data: { type: "string", description: "Optional identifier to link the result to a user" },
567
1111
  },
568
1112
  required: ["image_path"],
569
1113
  },
570
1114
  },
571
1115
  {
572
1116
  name: "didit_face_match",
573
- description: "Compare two facial images to determine if they belong to the same person (1:1 face matching).",
1117
+ description: "Compare two facial images to determine if they belong to the same person (1:1 face matching). The score is symmetric, so image order does not affect the result.",
574
1118
  inputSchema: {
575
1119
  type: "object",
576
1120
  properties: {
577
- image_1_path: { type: "string", description: "Absolute path to first facial image" },
578
- image_2_path: { type: "string", description: "Absolute path to second facial image" },
1121
+ image_1_path: { type: "string", description: "Absolute path to the first facial image (e.g. the selfie)" },
1122
+ image_2_path: { type: "string", description: "Absolute path to the second facial image (e.g. the ID portrait)" },
1123
+ vendor_data: { type: "string", description: "Optional identifier to link the result to a user" },
579
1124
  },
580
1125
  required: ["image_1_path", "image_2_path"],
581
1126
  },
@@ -587,6 +1132,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
587
1132
  type: "object",
588
1133
  properties: {
589
1134
  image_path: { type: "string", description: "Absolute path to facial image file" },
1135
+ vendor_data: { type: "string", description: "Optional identifier to link the result to a user" },
590
1136
  },
591
1137
  required: ["image_path"],
592
1138
  },
@@ -598,6 +1144,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
598
1144
  type: "object",
599
1145
  properties: {
600
1146
  image_path: { type: "string", description: "Absolute path to facial image file" },
1147
+ vendor_data: { type: "string", description: "Optional identifier to link the result to a user" },
601
1148
  },
602
1149
  required: ["image_path"],
603
1150
  },
@@ -605,14 +1152,19 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
605
1152
  // ── Standalone: AML Screening ───────────────────────────────────────
606
1153
  {
607
1154
  name: "didit_aml_screening",
608
- description: "AML screening against global watchlists, PEP lists, and sanctions databases. Supports person and company entity types.",
1155
+ description: "AML screening against global watchlists, PEP lists, sanctions, and (optionally) adverse media. Supports person and company entity types.",
609
1156
  inputSchema: {
610
1157
  type: "object",
611
1158
  properties: {
612
- full_name: { type: "string", description: "Full name to screen" },
613
- date_of_birth: { type: "string", description: "YYYY-MM-DD (optional, improves accuracy)" },
614
- entity_type: { type: "string", description: "person or company (default: person)" },
615
- countries: { type: "array", items: { type: "string" }, description: "ISO country codes to filter (optional)" },
1159
+ full_name: { type: "string", description: "REQUIRED. Full name to screen" },
1160
+ entity_type: { type: "string", enum: ["person", "company"], description: "Defaults to person" },
1161
+ date_of_birth: { type: "string", description: "YYYY-MM-DD (improves match accuracy)" },
1162
+ nationality: { type: "string", description: "ISO country code (improves match accuracy)" },
1163
+ document_number: { type: "string" },
1164
+ include_adverse_media: { type: "boolean", description: "Include adverse-media findings" },
1165
+ include_ongoing_monitoring: { type: "boolean", description: "Enroll the entity for ongoing monitoring" },
1166
+ vendor_data: { type: "string" },
1167
+ metadata: { type: "object" },
616
1168
  },
617
1169
  required: ["full_name"],
618
1170
  },
@@ -681,12 +1233,18 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
681
1233
  case "didit_verify_email":
682
1234
  result = await auth.verifyEmail(args.email, args.code);
683
1235
  break;
1236
+ case "didit_resend_otp":
1237
+ result = await auth.resendOtp(args.email);
1238
+ break;
684
1239
  case "didit_login":
685
1240
  result = await auth.login(args.email, args.password);
686
1241
  break;
687
1242
  case "didit_list_organizations":
688
1243
  result = await auth.listOrganizations(args.access_token);
689
1244
  break;
1245
+ case "didit_list_applications":
1246
+ result = await auth.listApplications(args.access_token, args.organization_id);
1247
+ break;
690
1248
  case "didit_get_application":
691
1249
  result = await auth.getApplication(args.access_token, args.organization_id, args.application_id);
692
1250
  break;
@@ -700,9 +1258,21 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
700
1258
  case "didit_get_session_decision":
701
1259
  result = await sessions.getSessionDecision(args.session_id);
702
1260
  break;
703
- case "didit_update_session_status":
704
- result = await sessions.updateSessionStatus(args.session_id, args.status);
1261
+ case "didit_update_session_status": {
1262
+ const { session_id, ...data } = args;
1263
+ result = await sessions.updateSessionStatus(session_id, data);
705
1264
  break;
1265
+ }
1266
+ case "didit_update_session_data": {
1267
+ const { session_id, ...data } = args;
1268
+ result = await sessions.updateSessionData(session_id, data);
1269
+ break;
1270
+ }
1271
+ case "didit_update_session_poa_data": {
1272
+ const { session_id, ...data } = args;
1273
+ result = await sessions.updateSessionPoaData(session_id, data);
1274
+ break;
1275
+ }
706
1276
  case "didit_delete_session":
707
1277
  result = await sessions.deleteSession(args.session_id);
708
1278
  break;
@@ -715,15 +1285,30 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
715
1285
  case "didit_list_session_reviews":
716
1286
  result = await sessions.listSessionReviews(args.session_id);
717
1287
  break;
718
- case "didit_add_session_review":
719
- result = await sessions.addSessionReview(args.session_id, args);
1288
+ case "didit_add_session_review": {
1289
+ const { session_id, ...data } = args;
1290
+ result = await sessions.addSessionReview(session_id, data);
720
1291
  break;
1292
+ }
721
1293
  case "didit_share_session":
722
1294
  result = await sessions.shareSession(args.session_id, args);
723
1295
  break;
724
1296
  case "didit_import_shared_session":
725
1297
  result = await sessions.importSharedSession(args);
726
1298
  break;
1299
+ // Session imports
1300
+ case "didit_create_import":
1301
+ result = await sessions.createImport(args);
1302
+ break;
1303
+ case "didit_get_import_template":
1304
+ result = await sessions.getImportTemplate();
1305
+ break;
1306
+ case "didit_get_import":
1307
+ result = await sessions.getImport(args.import_id);
1308
+ break;
1309
+ case "didit_get_import_errors":
1310
+ result = await sessions.getImportErrors(args.import_id);
1311
+ break;
727
1312
  // Workflows
728
1313
  case "didit_list_workflows":
729
1314
  result = await settings.listWorkflows();
@@ -764,6 +1349,9 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
764
1349
  case "didit_list_users":
765
1350
  result = await users.listUsers(args);
766
1351
  break;
1352
+ case "didit_create_user":
1353
+ result = await users.createUser(args);
1354
+ break;
767
1355
  case "didit_get_user":
768
1356
  result = await users.getUser(args.vendor_data);
769
1357
  break;
@@ -772,35 +1360,96 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
772
1360
  result = await users.updateUser(vendor_data, data);
773
1361
  break;
774
1362
  }
1363
+ case "didit_update_user_status":
1364
+ result = await users.updateUserStatus(args.vendor_data, args.status);
1365
+ break;
775
1366
  case "didit_delete_users":
776
1367
  result = await users.deleteUsers(args?.vendor_data_list, args?.delete_all);
777
1368
  break;
1369
+ // Businesses
1370
+ case "didit_list_businesses":
1371
+ result = await businesses.listBusinesses(args);
1372
+ break;
1373
+ case "didit_create_business":
1374
+ result = await businesses.createBusiness(args);
1375
+ break;
1376
+ case "didit_get_business":
1377
+ result = await businesses.getBusiness(args.vendor_data);
1378
+ break;
1379
+ case "didit_update_business": {
1380
+ const { vendor_data, ...data } = args;
1381
+ result = await businesses.updateBusiness(vendor_data, data);
1382
+ break;
1383
+ }
1384
+ case "didit_update_business_status":
1385
+ result = await businesses.updateBusinessStatus(args.vendor_data, args.status);
1386
+ break;
1387
+ case "didit_delete_businesses":
1388
+ result = await businesses.deleteBusinesses(args?.vendor_data_list, args?.didit_internal_id_list, args?.delete_all);
1389
+ break;
1390
+ // Transactions
1391
+ case "didit_list_transactions":
1392
+ result = await transactions.listTransactions(args);
1393
+ break;
1394
+ case "didit_create_transaction":
1395
+ result = await transactions.createTransaction(args);
1396
+ break;
1397
+ case "didit_get_transaction":
1398
+ result = await transactions.getTransaction(args.transaction_id);
1399
+ break;
1400
+ case "didit_screen_wallet":
1401
+ result = await transactions.screenWallet(args);
1402
+ break;
778
1403
  // Billing
779
1404
  case "didit_get_balance":
780
1405
  result = await billing.getBalance();
781
1406
  break;
782
1407
  case "didit_top_up":
783
- result = await billing.topUp(args.amount_in_dollars);
1408
+ result = await billing.topUp(args.amount_in_dollars, args?.success_url, args?.cancel_url);
784
1409
  break;
785
- // Webhook
786
- case "didit_get_webhook": {
787
- const res = await fetch(`${config_1.DIDIT_API_BASE_URL}/webhook/`, { headers: (0, config_1.getHeaders)() });
788
- result = await res.json();
1410
+ // Customization
1411
+ case "didit_get_customization":
1412
+ result = await customization.getCustomization();
789
1413
  break;
790
- }
791
- case "didit_update_webhook": {
792
- const res = await fetch(`${config_1.DIDIT_API_BASE_URL}/webhook/`, {
793
- method: "PATCH",
794
- headers: (0, config_1.getHeaders)(),
795
- body: JSON.stringify(args || {}),
796
- });
797
- result = await res.json();
1414
+ case "didit_update_customization":
1415
+ result = await customization.updateCustomization(args);
1416
+ break;
1417
+ // Webhook destinations
1418
+ case "didit_list_webhook_destinations":
1419
+ result = await webhooks.listDestinations();
1420
+ break;
1421
+ case "didit_create_webhook_destination":
1422
+ result = await webhooks.createDestination(args);
1423
+ break;
1424
+ case "didit_get_webhook_destination":
1425
+ result = await webhooks.getDestination(args.destination_uuid);
1426
+ break;
1427
+ case "didit_update_webhook_destination": {
1428
+ const { destination_uuid, ...data } = args;
1429
+ result = await webhooks.updateDestination(destination_uuid, data);
798
1430
  break;
799
1431
  }
1432
+ case "didit_delete_webhook_destination":
1433
+ result = await webhooks.deleteDestination(args.destination_uuid);
1434
+ break;
800
1435
  // Lists
801
1436
  case "didit_list_lists":
802
1437
  result = await lists.listLists(args);
803
1438
  break;
1439
+ case "didit_create_list":
1440
+ result = await lists.createList(args);
1441
+ break;
1442
+ case "didit_get_list":
1443
+ result = await lists.getListDetail(args.list_uuid);
1444
+ break;
1445
+ case "didit_update_list": {
1446
+ const { list_uuid: ulListUuid, ...ulData } = args;
1447
+ result = await lists.updateList(ulListUuid, ulData);
1448
+ break;
1449
+ }
1450
+ case "didit_delete_list":
1451
+ result = await lists.deleteList(args.list_uuid);
1452
+ break;
804
1453
  case "didit_list_entries": {
805
1454
  const { list_uuid: leListUuid, ...leParams } = args;
806
1455
  result = await lists.listEntries(leListUuid, leParams);
@@ -811,34 +1460,58 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
811
1460
  result = await lists.createEntry(ceListUuid, ceData);
812
1461
  break;
813
1462
  }
1463
+ case "didit_upload_face_entry": {
1464
+ const { list_uuid: ufListUuid, image_path, ...ufData } = args;
1465
+ result = await lists.uploadFaceEntry(ufListUuid, { image_path, ...ufData });
1466
+ break;
1467
+ }
814
1468
  case "didit_delete_list_entry": {
815
1469
  const { list_uuid: deListUuid, entry_uuid: deEntryUuid } = args;
816
1470
  result = await lists.deleteEntry(deListUuid, deEntryUuid);
817
1471
  break;
818
1472
  }
819
1473
  // Standalone: Identity & Documents
820
- case "didit_id_verification":
821
- result = await standalone.idVerification(args.front_image_path, args?.back_image_path);
1474
+ case "didit_id_verification": {
1475
+ const { front_image_path, back_image_path, ...idOpts } = args;
1476
+ result = await standalone.idVerification(front_image_path, back_image_path, idOpts);
822
1477
  break;
823
- case "didit_poa_verification":
824
- result = await standalone.poaVerification(args.front_image_path, args?.back_image_path);
1478
+ }
1479
+ case "didit_poa_verification": {
1480
+ const { document_image_path, ...poaOpts } = args;
1481
+ result = await standalone.poaVerification(document_image_path, poaOpts);
825
1482
  break;
1483
+ }
826
1484
  case "didit_database_validation":
827
1485
  result = await standalone.databaseValidation(args);
828
1486
  break;
1487
+ // Standalone: KYB registry
1488
+ case "didit_kyb_search":
1489
+ result = await standalone.kybSearch(args);
1490
+ break;
1491
+ case "didit_kyb_select":
1492
+ result = await standalone.kybSelect(args);
1493
+ break;
829
1494
  // Standalone: Biometrics
830
- case "didit_passive_liveness":
831
- result = await standalone.passiveLiveness(args.image_path);
1495
+ case "didit_passive_liveness": {
1496
+ const { image_path, ...plOpts } = args;
1497
+ result = await standalone.passiveLiveness(image_path, plOpts);
832
1498
  break;
833
- case "didit_face_match":
834
- result = await standalone.faceMatch(args.image_1_path, args.image_2_path);
1499
+ }
1500
+ case "didit_face_match": {
1501
+ const { image_1_path, image_2_path, ...fmOpts } = args;
1502
+ result = await standalone.faceMatch(image_1_path, image_2_path, fmOpts);
835
1503
  break;
836
- case "didit_face_search":
837
- result = await standalone.faceSearch(args.image_path);
1504
+ }
1505
+ case "didit_face_search": {
1506
+ const { image_path, ...fsOpts } = args;
1507
+ result = await standalone.faceSearch(image_path, fsOpts);
838
1508
  break;
839
- case "didit_age_estimation":
840
- result = await standalone.ageEstimation(args.image_path);
1509
+ }
1510
+ case "didit_age_estimation": {
1511
+ const { image_path, ...aeOpts } = args;
1512
+ result = await standalone.ageEstimation(image_path, aeOpts);
841
1513
  break;
1514
+ }
842
1515
  // Standalone: AML
843
1516
  case "didit_aml_screening":
844
1517
  result = await standalone.amlScreening(args);
@@ -869,7 +1542,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
869
1542
  async function main() {
870
1543
  const transport = new stdio_js_1.StdioServerTransport();
871
1544
  await server.connect(transport);
872
- console.error("Didit MCP Server v3.0.0 running on stdio");
1545
+ console.error(`Didit MCP Server v${SERVER_VERSION} running on stdio`);
873
1546
  }
874
1547
  main().catch(console.error);
875
1548
  //# sourceMappingURL=index.js.map