Didit
Didit provides identity verification, KYC, KYB, AML, fraud prevention, and compliance APIs for onboarding and ongoing risk operations.
Verdict
Common use cases
- Create KYC sessions for new signups
- Check credit balance before batch verifications
- Pull verification decisions during support calls
- List flagged user profiles for compliance review
- Fetch business registry data for due diligence
Integration
- Vendor
- Didit
- Category
- other
- Auth
- API_KEY
- Tools
- 10
- Composio slug
didit
Tools
- Create Verification Session
Create a hosted KYC or KYB verification session from a published workflow and return the URL to give the end user. This may consume Didit credits and sends an invitation email only when explicitly requested.
- Get Billing Balance
Read the organization's prepaid Didit credit balance and auto-refill settings before starting billable verification work.
- Get Business
Fetch one aggregated KYB business profile by its exact vendor_data identifier.
- Get User
Fetch one aggregated KYC user profile by its exact vendor_data identifier. Returns the complete provider record, including identity summary, session aggregation, metadata, tags, and comments or activity.
- Get Verification Decision
Retrieve the complete current KYC or KYB decision and all feature reports for one verification session. Feature report arrays and unknown provider fields are preserved; media URLs in the result are short-lived.
- Get Workflow
Fetch the full configuration and pricing of one workflow version.
- List Businesses
List business profiles aggregated from KYB sessions, including status, session counts, registry identifiers, and verification summaries. Didit does not support filters or search on this endpoint.
- List Users
List user profiles aggregated from KYC sessions, including status, session counts, and feature summaries. Didit does not support filters on this endpoint.
- List Verification Sessions
List and filter KYC, KYB, or standalone verification sessions. Returns one bounded page and a continuation cursor.
- List Workflows
List configured verification workflow versions, their publication status, feature summary, and expected per-run pricing.
Setup
Setup guide
- 11. In Switchy, open Settings and navigate to the Integrations tab. 2. Find Didit in the MCP catalog and click Connect. 3. You'll be prompted to paste an API key — generate one in your Didit dashboard under Organization Settings > API Keys with at least read scope for sessions and workflows, plus write scope if you plan to create new verification sessions. 4. Paste the key into Switchy and click Authorize. 5. Open any Project and type '@Didit get billing balance' to confirm the connection works — you should see your current credit balance and auto-refill settings. 6. To test session creation, run '@Didit create verification session' and provide a workflow ID from your Didit account; the MCP will return a hosted URL you can share with an end user.
What teammates see: by default, memories from Didit are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Check Credit Balance
@Didit get my current billing balance and auto-refill settings. Let me know if I'm running low before I start 50 new KYC sessions.
Create Verification Session
@Didit create a verification session using workflow ID wf_abc123. Return the hosted URL so I can email it to the customer.
Retrieve Verification Decision
@Didit get the verification decision for session ses_xyz789. Show me which document checks failed and whether the address matched.
List Flagged Users
@Didit list all user profiles with a pending or flagged status. Include session counts and verification summaries so I can prioritize manual review.
Fetch Business Profile
@Didit get the business profile for vendor_data ID biz_456def. Show me registry identifiers, verification summaries, and any comments from past sessions.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Didit check our prepaid credit balance and show me the auto-refill threshold before I launch the next batch of verifications.
Your organization currently holds 2,450 Didit credits. Auto-refill is enabled with a threshold of 500 credits—when your balance drops below that level, the system will automatically purchase 5,000 credits using the payment method on file. Each standard KYC verification consumes approximately 10–15 credits depending on the workflow configuration and document types submitted.
This example demonstrates read-only billing visibility before you commit to credit-consuming operations. Useful for cost control when planning bulk verification campaigns. Requires the Didit API key to have billing:read scope; does not trigger any charges or side effects.
@Didit create a new KYC verification session using our 'Standard Identity' workflow for user emma.chen@example.com and give me the hosted URL.
Verification session created successfully. Session ID: vs_8x3kLm9pQr2. The hosted verification URL is https://verify.didit.me/s/vs_8x3kLm9pQr2—send this link to Emma Chen so she can complete identity document upload, liveness check, and address proof. An invitation email was not sent automatically; you must share the URL directly. This session will consume credits only when the user submits documents and Didit runs the verification checks.
This write action provisions a billable resource and returns a URL your end user must visit. The MCP does not send the invitation email unless you explicitly request it in the prompt. Verify your workflow ID and user email are correct before running—session creation is immediate and may decrement your credit balance once the user starts.
@Didit pull all user profiles created in the last 30 days, then summarize how many passed, failed, or are still pending verification.
Didit returned 47 user profiles. Of those, 34 users passed verification (status: approved), 8 failed due to document mismatch or liveness issues (status: rejected), and 5 remain in pending status awaiting manual review or additional documents. Note that Didit's List Users endpoint does not support date-range filters, so this summary reflects all profiles in your account; I filtered by creation timestamp client-side to isolate the last 30 days.
This synthesis example pairs the MCP's list capability with AI reasoning to produce a status breakdown. Be aware that Didit does not offer server-side filtering—large account datasets may require pagination and client-side filtering, which can be slow. The MCP fetches raw profile arrays; the AI performs the aggregation and date logic.
Use-case deep-dives
When Didit fits a regulated onboarding flow with light volume
A 6-person fintech startup runs KYC on 40-60 new users per month and needs audit trails for their banking partner. Didit works here because the team can create verification sessions from Switchy, check billing balance before each batch, and pull complete decision reports into a shared context when the compliance lead reviews flagged accounts. The Get Verification Decision and Get User tools give you the full provider record without leaving the workspace, so the ops person and the engineer can triage edge cases together in one thread. The threshold: if you're onboarding 500+ users a month or need real-time webhook orchestration, you'll outgrow the list-and-fetch pattern fast. For early-stage regulated products where a human reviews every decision anyway, this MCP turns Didit's API into a compliance copilot.
Why Didit's KYB tools help marketplace ops at sub-100 seller scale
A marketplace with 30 active sellers uses Didit for business verification before payout approval. The ops lead creates a KYB session in Switchy when a new seller applies, then fetches the business profile and decision report once verification completes. List Businesses and Get Business let the team spot patterns across flagged sellers without opening the Didit dashboard—useful when the trust-and-safety person and the payments engineer need to decide together whether to approve a borderline case. The catch: Didit's list endpoints don't support filters or search, so if you're vetting 200+ businesses a month, you'll spend more time scrolling than deciding. For small marketplaces where every seller gets individual attention, this MCP keeps verification context in the same workspace as your payout and fraud discussions.
When Didit's workflow config lookup speeds multi-client compliance setup
A 4-person compliance consultancy manages KYC workflows for 8 fintech clients, each with different risk appetites and verification requirements. The Get Workflow tool lets the team pull a client's full configuration and pricing into Switchy when scoping a new project or troubleshooting a session failure. Instead of screenshotting the Didit dashboard or asking the client to export settings, the consultant fetches the workflow version in a shared thread and walks the client through trade-offs in real time. The limit: if you're running dozens of workflows or need to diff configurations programmatically, the 10-tool MCP won't give you bulk export or comparison logic. For agencies where each client conversation is bespoke and the workflow config is the source of truth, this MCP turns Didit into a scoping artifact you can reference mid-conversation.
Frequently asked
What does the Didit MCP do in Switchy?
It lets your AI agents run identity verification workflows directly from chat. You can create KYC or KYB sessions, check verification decisions, pull user or business profiles, and monitor your prepaid credit balance without leaving Switchy. The MCP wraps Didit's hosted verification API so agents can trigger compliance checks as part of larger workflows.
Do I need admin access to connect Didit?
You need an API key with permission to create sessions and read verification results. Didit uses API_KEY auth, so whoever connects the MCP must have access to your organization's key in the Didit dashboard. If your team restricts key distribution, ask your compliance or ops lead to generate one with the scopes you need.
Can the MCP search or filter users by name or email?
No. Didit's API does not support filters or search on the List Users or List Businesses endpoints, and the MCP mirrors that limitation. You can list all profiles or fetch one by its exact vendor_data identifier, but you cannot query by partial name, email, or custom tags through the MCP.
Why use this instead of calling Didit's API directly?
The MCP saves you from writing integration code every time you want to check a verification status or start a session. Your agents can ask "What's the KYC decision for user X?" and get a structured answer in seconds. If you already have a custom Didit integration, you probably don't need this.
Who on the team should connect the Didit MCP?
Whoever owns compliance tooling or has access to your Didit API keys. Creating verification sessions consumes prepaid credits, so the person connecting it should understand your billing limits and workflow pricing. Once connected, any team member in the Switchy workspace can trigger verification tools through agents.