Skip to main content

​
Overview

Didit provides a Model Context Protocol (MCP) server that lets AI coding agents interact with the Didit identity verification platform directly. Agents can register accounts, create verification sessions, configure workflows, manage questionnaires, and handle billing — all through natural language commands. Didit is built for the agentic era. While other verification platforms require manual console setup, Didit lets agents:
  • Self-register via programmatic API (no browser needed)
  • Configure verification workflows via API
  • Create and manage sessions programmatically
  • Monitor billing and top up credits via API
  • Build complete integrations end-to-end without human intervention

​
Setup

​
1. Install

Add to your MCP configuration (e.g., .cursor/mcp.json or claude_desktop_config.json): 
{
  "mcpServers": {
    "didit": {
      "command": "npx",
      "args": ["@didit-protocol/mcp-server"],
      "env": {
        "DIDIT_API_KEY": "your_api_key_here"
      }
    }
  }
}

​
2. Get Your API Key

If you don’t have an API key yet, the agent can register for you:
  1. Agent calls didit_register with your email and a password
  2. You receive a 6-character code via email
  3. Agent calls didit_verify_email with the code
  4. The response includes your api_key
Set this api_key as DIDIT_API_KEY in the MCP config.

​
Available Tools

​
Auth

ToolDescription
didit_registerRegister a new account
didit_verify_emailVerify email with OTP code, get API credentials
didit_loginLogin to existing account
didit_list_organizationsList your organizations
didit_get_applicationGet application details (client_id, api_key)

​
Sessions

ToolDescription
didit_create_sessionCreate a verification session
didit_list_sessionsList sessions with filters
didit_get_session_decisionGet full session decision/result
didit_update_session_statusApprove, decline, or request resubmission
didit_delete_sessionDelete a single session
didit_batch_delete_sessionsDelete multiple sessions at once
didit_generate_session_pdfGenerate a PDF verification report
didit_list_session_reviewsList review history for a session
didit_add_session_reviewAdd a review note to a session
didit_share_sessionShare a session with a partner (Reusable KYC)
didit_import_shared_sessionImport a shared session from a partner

​
Workflows

ToolDescription
didit_list_workflowsList verification workflows
didit_create_workflowCreate a new workflow
didit_get_workflowGet workflow configuration
didit_update_workflowUpdate workflow settings
didit_delete_workflowDelete a workflow

​
Questionnaires

ToolDescription
didit_list_questionnairesList custom questionnaires
didit_create_questionnaireCreate a questionnaire
didit_get_questionnaireGet questionnaire details
didit_update_questionnaireUpdate a questionnaire
didit_delete_questionnaireDelete a questionnaire

​
Users

ToolDescription
didit_list_usersList verified users
didit_get_userGet user by vendor_data
didit_update_userUpdate user metadata
didit_delete_usersBatch delete users

​
Billing

ToolDescription
didit_get_balanceCheck credit balance
didit_top_upCreate checkout to add credits

​
Blocklist

ToolDescription
didit_list_blocklistList blocklist entries
didit_add_to_blocklistAdd items to blocklist by session
didit_remove_from_blocklistRemove items from blocklist

​
Standalone APIs

ToolDescription
didit_id_verificationVerify identity documents (OCR + authenticity)
didit_poa_verificationProof of address verification
didit_database_validationValidate identity against authoritative databases
didit_passive_livenessPassive liveness detection from a single image
didit_face_matchCompare two faces (1:1 matching)
didit_face_searchSearch face against verified database (1:N)
didit_age_estimationEstimate age from facial image
didit_aml_screeningAML/sanctions/PEP screening
didit_email_sendSend email verification code
didit_email_checkVerify email OTP code
didit_phone_sendSend phone verification code
didit_phone_checkVerify phone OTP code

​
Example Conversation

You: “Set up Didit identity verification for my app with ID scan and liveness” Agent: I’ll register a Didit account for you. What email should I use? You: “use dev@company.com” Agent: calls didit_register — Check your email for a 6-character code. You: “The code is A3K9F2” Agent: calls didit_verify_email — Account ready! Now let me create your workflow… calls didit_create_workflow with ID scan + liveness enabled Done! Your workflow “Standard KYC” is set up with:
  • ID document scanning (passport, ID card, driver’s license)
  • Liveness detection (anti-spoofing)
Here’s how to create a verification session in your code: 
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"callback_url": "https://myapp.com/callback"}'