@didit-protocol/mcp-server 3.0.2 → 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 +78 -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 +830 -100
  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 +10 -0
  24. package/dist/tools/lists.d.ts.map +1 -0
  25. package/dist/tools/lists.js +50 -0
  26. package/dist/tools/lists.js.map +1 -0
  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 +10 -2
  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,10 +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
- const blocklist = __importStar(require("./tools/blocklist"));
50
+ const lists = __importStar(require("./tools/lists"));
47
51
  const standalone = __importStar(require("./tools/standalone"));
48
- 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: {} } });
49
90
  // ---------------------------------------------------------------------------
50
91
  // Tool definitions
51
92
  // ---------------------------------------------------------------------------
@@ -76,6 +117,17 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
76
117
  required: ["email", "code"],
77
118
  },
78
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
+ },
79
131
  {
80
132
  name: "didit_login",
81
133
  description: "Login to existing Didit account. Returns access_token and refresh_token.",
@@ -99,6 +151,18 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
99
151
  required: ["access_token"],
100
152
  },
101
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
+ },
102
166
  {
103
167
  name: "didit_get_application",
104
168
  description: "Get application details including client_id and api_key. Requires access_token.",
@@ -115,25 +179,37 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
115
179
  // ── Sessions ────────────────────────────────────────────────────────
116
180
  {
117
181
  name: "didit_create_session",
118
- 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.",
119
183
  inputSchema: {
120
184
  type: "object",
121
185
  properties: {
122
- callback_url: { type: "string", description: "URL to redirect user after verification" },
123
- vendor_data: { type: "string", description: "Your unique identifier for the user (e.g. user ID)" },
124
- 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" },
125
195
  },
196
+ required: ["workflow_id"],
126
197
  },
127
198
  },
128
199
  {
129
200
  name: "didit_list_sessions",
130
- 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}.`,
131
202
  inputSchema: {
132
203
  type: "object",
133
204
  properties: {
134
- 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" },
135
207
  vendor_data: { type: "string", description: "Filter by vendor_data" },
136
- 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)" },
137
213
  offset: { type: "string", description: "Pagination offset" },
138
214
  },
139
215
  },
@@ -151,14 +227,67 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
151
227
  },
152
228
  {
153
229
  name: "didit_update_session_status",
154
- 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.",
155
231
  inputSchema: {
156
232
  type: "object",
157
233
  properties: {
158
234
  session_id: { type: "string" },
159
- status: { type: "string", description: "New status: Approved, Declined, Resubmission Requested" },
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" },
160
241
  },
161
- required: ["session_id", "status"],
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.",
276
+ inputSchema: {
277
+ type: "object",
278
+ properties: {
279
+ session_id: { type: "string" },
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" },
289
+ },
290
+ required: ["session_id"],
162
291
  },
163
292
  },
164
293
  {
@@ -211,13 +340,17 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
211
340
  },
212
341
  {
213
342
  name: "didit_add_session_review",
214
- 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.",
215
344
  inputSchema: {
216
345
  type: "object",
217
346
  properties: {
218
347
  session_id: { type: "string" },
219
348
  comment: { type: "string", description: "Review comment or note" },
220
- 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
+ },
221
354
  },
222
355
  required: ["session_id"],
223
356
  },
@@ -245,6 +378,48 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
245
378
  required: ["share_token"],
246
379
  },
247
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
+ },
248
423
  // ── Workflows (Verification Settings) ───────────────────────────────
249
424
  {
250
425
  name: "didit_list_workflows",
@@ -253,22 +428,26 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
253
428
  },
254
429
  {
255
430
  name: "didit_create_workflow",
256
- 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.",
257
432
  inputSchema: {
258
433
  type: "object",
259
434
  properties: {
260
- 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
+ },
261
442
  is_default: { type: "boolean", description: "Set as default workflow for new sessions" },
262
- is_ocr_enabled: { type: "boolean", description: "Enable ID document scanning" },
263
- is_face_match_enabled: { type: "boolean", description: "Enable face match against ID photo" },
264
- is_liveness_enabled: { type: "boolean", description: "Enable anti-spoofing liveness detection" },
265
- is_aml_enabled: { type: "boolean", description: "Enable AML/sanctions screening" },
266
- is_phone_verification_enabled: { type: "boolean", description: "Enable phone number verification" },
267
- is_email_verification_enabled: { type: "boolean", description: "Enable email verification" },
268
- is_poa_enabled: { type: "boolean", description: "Enable proof of address" },
269
- 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" },
270
449
  },
271
- required: ["workflow_label"],
450
+ required: ["features"],
272
451
  },
273
452
  },
274
453
  {
@@ -284,21 +463,24 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
284
463
  },
285
464
  {
286
465
  name: "didit_update_workflow",
287
- 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.",
288
467
  inputSchema: {
289
468
  type: "object",
290
469
  properties: {
291
470
  workflow_id: { type: "string", description: "Workflow UUID" },
292
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
+ },
293
477
  is_default: { type: "boolean" },
294
- is_ocr_enabled: { type: "boolean" },
295
- is_face_match_enabled: { type: "boolean" },
296
- is_liveness_enabled: { type: "boolean" },
297
- is_aml_enabled: { type: "boolean" },
298
- is_phone_verification_enabled: { type: "boolean" },
299
- is_email_verification_enabled: { type: "boolean" },
300
- is_poa_enabled: { type: "boolean" },
301
- 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" },
302
484
  },
303
485
  required: ["workflow_id"],
304
486
  },
@@ -372,19 +554,37 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
372
554
  required: ["questionnaire_id"],
373
555
  },
374
556
  },
375
- // ── Users ───────────────────────────────────────────────────────────
557
+ // ── Users (verified individuals / KYC) ──────────────────────────────
376
558
  {
377
559
  name: "didit_list_users",
378
- description: "List all verified users. Supports pagination and status filtering.",
560
+ description: "List verified users (grouped by vendor_data). Supports limit/offset pagination.",
379
561
  inputSchema: {
380
562
  type: "object",
381
563
  properties: {
382
- status: { type: "string", description: "Filter: Approved, Declined, In Review, Pending" },
383
564
  limit: { type: "string" },
384
565
  offset: { type: "string" },
385
566
  },
386
567
  },
387
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
+ },
388
588
  {
389
589
  name: "didit_get_user",
390
590
  description: "Get details of a specific user by their vendor_data identifier.",
@@ -398,16 +598,35 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
398
598
  },
399
599
  {
400
600
  name: "didit_update_user",
401
- 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.",
402
602
  inputSchema: {
403
603
  type: "object",
404
604
  properties: {
405
605
  vendor_data: { type: "string", description: "The vendor_data value that identifies the user" },
406
- 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" } },
407
614
  },
408
615
  required: ["vendor_data"],
409
616
  },
410
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
+ },
411
630
  {
412
631
  name: "didit_delete_users",
413
632
  description: "Batch delete users by vendor_data list, or delete all users.",
@@ -423,6 +642,155 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
423
642
  },
424
643
  },
425
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
+ },
426
794
  // ── Billing ─────────────────────────────────────────────────────────
427
795
  {
428
796
  name: "didit_get_balance",
@@ -436,51 +804,207 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
436
804
  type: "object",
437
805
  properties: {
438
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" },
439
809
  },
440
810
  required: ["amount_in_dollars"],
441
811
  },
442
812
  },
443
- // ── Blocklist ───────────────────────────────────────────────────────
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
+ },
444
819
  {
445
- name: "didit_list_blocklist",
446
- description: "List blocklist entries. Filter by item_type: face, document, phone, email.",
820
+ name: "didit_update_customization",
821
+ description: "Update verification UI branding images. Provide absolute file paths for the images you want to set.",
447
822
  inputSchema: {
448
823
  type: "object",
449
824
  properties: {
450
- item_type: { type: "string", description: "Filter: face, document, phone, email" },
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 ────────────────────────────────────────────
832
+ {
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.",
835
+ inputSchema: { type: "object", properties: {} },
836
+ },
837
+ {
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.",
882
+ inputSchema: {
883
+ type: "object",
884
+ properties: {
885
+ destination_uuid: { type: "string", description: "Webhook destination UUID" },
886
+ },
887
+ required: ["destination_uuid"],
888
+ },
889
+ },
890
+ // ── Lists (Blocklists, Allowlists & Custom) ─────────────────────────
891
+ {
892
+ name: "didit_list_lists",
893
+ description: "List all lists (blocklists, allowlists, custom) for the application. Filter by list_type or entry_type.",
894
+ inputSchema: {
895
+ type: "object",
896
+ properties: {
897
+ list_type: { type: "string", description: "Filter: blocklist, allowlist, custom" },
898
+ entry_type: { type: "string", description: `Filter: ${LIST_ENTRY_TYPES.join(", ")}` },
451
899
  limit: { type: "string" },
452
900
  offset: { type: "string" },
453
901
  },
454
902
  },
455
903
  },
456
904
  {
457
- name: "didit_add_to_blocklist",
458
- description: "Add faces, documents, phones, and/or emails to the blocklist by session ID.",
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.",
459
907
  inputSchema: {
460
908
  type: "object",
461
909
  properties: {
462
- session_id: { type: "string", description: "Session UUID to blocklist items from" },
463
- face: { type: "boolean", description: "Block the face from this session" },
464
- document: { type: "boolean", description: "Block the document from this session" },
465
- phone: { type: "boolean", description: "Block the phone from this session" },
466
- email: { type: "boolean", description: "Block the email from this session" },
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" },
467
914
  },
468
- required: ["session_id"],
915
+ required: ["name", "list_type", "entry_type"],
469
916
  },
470
917
  },
471
918
  {
472
- name: "didit_remove_from_blocklist",
473
- description: "Remove faces, documents, phones, and/or emails from the blocklist by session ID.",
919
+ name: "didit_get_list",
920
+ description: "Get a single list's details by UUID.",
474
921
  inputSchema: {
475
922
  type: "object",
476
923
  properties: {
477
- session_id: { type: "string", description: "Session UUID to unblock items from" },
478
- face: { type: "boolean" },
479
- document: { type: "boolean" },
480
- phone: { type: "boolean" },
481
- email: { type: "boolean" },
924
+ list_uuid: { type: "string", description: "UUID of the list" },
482
925
  },
483
- required: ["session_id"],
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
+ },
953
+ {
954
+ name: "didit_list_entries",
955
+ description: "List entries in a specific list. Use search to filter by value or label.",
956
+ inputSchema: {
957
+ type: "object",
958
+ properties: {
959
+ list_uuid: { type: "string", description: "UUID of the list" },
960
+ search: { type: "string", description: "Search by value or display label" },
961
+ limit: { type: "string" },
962
+ offset: { type: "string" },
963
+ },
964
+ required: ["list_uuid"],
965
+ },
966
+ },
967
+ {
968
+ name: "didit_create_list_entry",
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.",
970
+ inputSchema: {
971
+ type: "object",
972
+ properties: {
973
+ list_uuid: { type: "string", description: "UUID of the list to add to" },
974
+ value: { type: "string", description: "Value to add (phone, email, IP, etc.). Optional if reference_session_id is provided." },
975
+ reference_session_id: { type: "string", description: "Session UUID — backend auto-extracts the value based on the list's entry type" },
976
+ reference_object_uuid: { type: "string", description: "UUID of the source entity (transaction, vendor user/business) for traceability" },
977
+ display_label: { type: "string", description: "Human-readable label" },
978
+ comment: { type: "string", description: "Reason for adding" },
979
+ metadata: { type: "object", description: "Additional structured data (e.g. reference_type, full_name)" },
980
+ },
981
+ required: ["list_uuid"],
982
+ },
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
+ },
998
+ {
999
+ name: "didit_delete_list_entry",
1000
+ description: "Remove an entry from a list. Also unblocks the underlying user/business if applicable.",
1001
+ inputSchema: {
1002
+ type: "object",
1003
+ properties: {
1004
+ list_uuid: { type: "string", description: "UUID of the list" },
1005
+ entry_uuid: { type: "string", description: "UUID of the entry to remove" },
1006
+ },
1007
+ required: ["list_uuid", "entry_uuid"],
484
1008
  },
485
1009
  },
486
1010
  // ── Standalone: Identity & Documents ────────────────────────────────
@@ -492,35 +1016,87 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
492
1016
  properties: {
493
1017
  front_image_path: { type: "string", description: "Absolute path to front image file" },
494
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" },
495
1023
  },
496
1024
  required: ["front_image_path"],
497
1025
  },
498
1026
  },
499
1027
  {
500
1028
  name: "didit_poa_verification",
501
- 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.",
502
1030
  inputSchema: {
503
1031
  type: "object",
504
1032
  properties: {
505
- front_image_path: { type: "string", description: "Absolute path to front image file" },
506
- 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" },
507
1039
  },
508
- required: ["front_image_path"],
1040
+ required: ["document_image_path"],
509
1041
  },
510
1042
  },
511
1043
  {
512
1044
  name: "didit_database_validation",
513
- 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.",
514
1046
  inputSchema: {
515
1047
  type: "object",
516
1048
  properties: {
1049
+ issuing_state: { type: "string", description: "REQUIRED. ISO 3166-1 alpha-2 country code that selects the data sources to query" },
517
1050
  first_name: { type: "string" },
518
1051
  last_name: { type: "string" },
519
- 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" },
520
1055
  document_number: { type: "string" },
521
- 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" },
522
1084
  },
523
- required: ["first_name", "last_name", "date_of_birth", "country"],
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" },
1098
+ },
1099
+ required: ["kyb_response_id"],
524
1100
  },
525
1101
  },
526
1102
  // ── Standalone: Biometrics & Face ───────────────────────────────────
@@ -531,18 +1107,20 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
531
1107
  type: "object",
532
1108
  properties: {
533
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" },
534
1111
  },
535
1112
  required: ["image_path"],
536
1113
  },
537
1114
  },
538
1115
  {
539
1116
  name: "didit_face_match",
540
- 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.",
541
1118
  inputSchema: {
542
1119
  type: "object",
543
1120
  properties: {
544
- image_1_path: { type: "string", description: "Absolute path to first facial image" },
545
- 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" },
546
1124
  },
547
1125
  required: ["image_1_path", "image_2_path"],
548
1126
  },
@@ -554,6 +1132,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
554
1132
  type: "object",
555
1133
  properties: {
556
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" },
557
1136
  },
558
1137
  required: ["image_path"],
559
1138
  },
@@ -565,6 +1144,7 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
565
1144
  type: "object",
566
1145
  properties: {
567
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" },
568
1148
  },
569
1149
  required: ["image_path"],
570
1150
  },
@@ -572,14 +1152,19 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
572
1152
  // ── Standalone: AML Screening ───────────────────────────────────────
573
1153
  {
574
1154
  name: "didit_aml_screening",
575
- 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.",
576
1156
  inputSchema: {
577
1157
  type: "object",
578
1158
  properties: {
579
- full_name: { type: "string", description: "Full name to screen" },
580
- date_of_birth: { type: "string", description: "YYYY-MM-DD (optional, improves accuracy)" },
581
- entity_type: { type: "string", description: "person or company (default: person)" },
582
- 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" },
583
1168
  },
584
1169
  required: ["full_name"],
585
1170
  },
@@ -648,12 +1233,18 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
648
1233
  case "didit_verify_email":
649
1234
  result = await auth.verifyEmail(args.email, args.code);
650
1235
  break;
1236
+ case "didit_resend_otp":
1237
+ result = await auth.resendOtp(args.email);
1238
+ break;
651
1239
  case "didit_login":
652
1240
  result = await auth.login(args.email, args.password);
653
1241
  break;
654
1242
  case "didit_list_organizations":
655
1243
  result = await auth.listOrganizations(args.access_token);
656
1244
  break;
1245
+ case "didit_list_applications":
1246
+ result = await auth.listApplications(args.access_token, args.organization_id);
1247
+ break;
657
1248
  case "didit_get_application":
658
1249
  result = await auth.getApplication(args.access_token, args.organization_id, args.application_id);
659
1250
  break;
@@ -667,9 +1258,21 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
667
1258
  case "didit_get_session_decision":
668
1259
  result = await sessions.getSessionDecision(args.session_id);
669
1260
  break;
670
- case "didit_update_session_status":
671
- 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);
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);
672
1274
  break;
1275
+ }
673
1276
  case "didit_delete_session":
674
1277
  result = await sessions.deleteSession(args.session_id);
675
1278
  break;
@@ -682,15 +1285,30 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
682
1285
  case "didit_list_session_reviews":
683
1286
  result = await sessions.listSessionReviews(args.session_id);
684
1287
  break;
685
- case "didit_add_session_review":
686
- 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);
687
1291
  break;
1292
+ }
688
1293
  case "didit_share_session":
689
1294
  result = await sessions.shareSession(args.session_id, args);
690
1295
  break;
691
1296
  case "didit_import_shared_session":
692
1297
  result = await sessions.importSharedSession(args);
693
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;
694
1312
  // Workflows
695
1313
  case "didit_list_workflows":
696
1314
  result = await settings.listWorkflows();
@@ -731,6 +1349,9 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
731
1349
  case "didit_list_users":
732
1350
  result = await users.listUsers(args);
733
1351
  break;
1352
+ case "didit_create_user":
1353
+ result = await users.createUser(args);
1354
+ break;
734
1355
  case "didit_get_user":
735
1356
  result = await users.getUser(args.vendor_data);
736
1357
  break;
@@ -739,49 +1360,158 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
739
1360
  result = await users.updateUser(vendor_data, data);
740
1361
  break;
741
1362
  }
1363
+ case "didit_update_user_status":
1364
+ result = await users.updateUserStatus(args.vendor_data, args.status);
1365
+ break;
742
1366
  case "didit_delete_users":
743
1367
  result = await users.deleteUsers(args?.vendor_data_list, args?.delete_all);
744
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;
745
1403
  // Billing
746
1404
  case "didit_get_balance":
747
1405
  result = await billing.getBalance();
748
1406
  break;
749
1407
  case "didit_top_up":
750
- result = await billing.topUp(args.amount_in_dollars);
1408
+ result = await billing.topUp(args.amount_in_dollars, args?.success_url, args?.cancel_url);
1409
+ break;
1410
+ // Customization
1411
+ case "didit_get_customization":
1412
+ result = await customization.getCustomization();
1413
+ break;
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);
1430
+ break;
1431
+ }
1432
+ case "didit_delete_webhook_destination":
1433
+ result = await webhooks.deleteDestination(args.destination_uuid);
1434
+ break;
1435
+ // Lists
1436
+ case "didit_list_lists":
1437
+ result = await lists.listLists(args);
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);
751
1448
  break;
752
- // Blocklist
753
- case "didit_list_blocklist":
754
- result = await blocklist.listBlocklist(args);
1449
+ }
1450
+ case "didit_delete_list":
1451
+ result = await lists.deleteList(args.list_uuid);
1452
+ break;
1453
+ case "didit_list_entries": {
1454
+ const { list_uuid: leListUuid, ...leParams } = args;
1455
+ result = await lists.listEntries(leListUuid, leParams);
755
1456
  break;
756
- case "didit_add_to_blocklist":
757
- result = await blocklist.addToBlocklist(args);
1457
+ }
1458
+ case "didit_create_list_entry": {
1459
+ const { list_uuid: ceListUuid, ...ceData } = args;
1460
+ result = await lists.createEntry(ceListUuid, ceData);
1461
+ break;
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 });
758
1466
  break;
759
- case "didit_remove_from_blocklist":
760
- result = await blocklist.removeFromBlocklist(args);
1467
+ }
1468
+ case "didit_delete_list_entry": {
1469
+ const { list_uuid: deListUuid, entry_uuid: deEntryUuid } = args;
1470
+ result = await lists.deleteEntry(deListUuid, deEntryUuid);
761
1471
  break;
1472
+ }
762
1473
  // Standalone: Identity & Documents
763
- case "didit_id_verification":
764
- 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);
765
1477
  break;
766
- case "didit_poa_verification":
767
- 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);
768
1482
  break;
1483
+ }
769
1484
  case "didit_database_validation":
770
1485
  result = await standalone.databaseValidation(args);
771
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;
772
1494
  // Standalone: Biometrics
773
- case "didit_passive_liveness":
774
- 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);
775
1498
  break;
776
- case "didit_face_match":
777
- 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);
778
1503
  break;
779
- case "didit_face_search":
780
- 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);
781
1508
  break;
782
- case "didit_age_estimation":
783
- 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);
784
1513
  break;
1514
+ }
785
1515
  // Standalone: AML
786
1516
  case "didit_aml_screening":
787
1517
  result = await standalone.amlScreening(args);
@@ -812,7 +1542,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
812
1542
  async function main() {
813
1543
  const transport = new stdio_js_1.StdioServerTransport();
814
1544
  await server.connect(transport);
815
- console.error("Didit MCP Server v3.0.0 running on stdio");
1545
+ console.error(`Didit MCP Server v${SERVER_VERSION} running on stdio`);
816
1546
  }
817
1547
  main().catch(console.error);
818
1548
  //# sourceMappingURL=index.js.map