# Didit — how to use (mcp.ai)

Connect your Didit account and use 10 tools for security and identity straight from your AI agent. Connect with your own API key. Didit provides identity verification, KYC, KYB, AML, fraud prevention, and compliance APIs for onboarding and ongoing risk operations.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_didit?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `didit_create_verification_session`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/didit`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/didit/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/didit/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 req
  - body: { language?: string, metadata?: object, vendor_data?: string, workflow_id: string, callback_url?: string, callback_method?: string, contact_details?: object, expected_details?: object, sandbox_scenario?: string, portrait_image_base64?: string }
- `POST https://api.mcp.ai/api/didit/get/billing/balance` — Read the organization's prepaid Didit credit balance and auto-refill settings before starting billable verification work.
- `POST https://api.mcp.ai/api/didit/get/business` — Fetch one aggregated KYB business profile by its exact vendor_data identifier.
  - body: { vendor_data: string }
- `POST https://api.mcp.ai/api/didit/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 activi
  - body: { vendor_data: string }
- `POST https://api.mcp.ai/api/didit/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 sh
  - body: { session_id: string, include_events?: boolean }
- `POST https://api.mcp.ai/api/didit/get/workflow` — Fetch the full configuration and pricing of one workflow version.
  - body: { workflow_version_id: string }
- `POST https://api.mcp.ai/api/didit/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.
  - body: { limit?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/didit/list/users` — List user profiles aggregated from KYC sessions, including status, session counts, and feature summaries. Didit does not support filters on this endpoint.
  - body: { limit?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/didit/list/verification/sessions` — List and filter KYC, KYB, or standalone verification sessions. Returns one bounded page and a continuation cursor.
  - body: { limit?: integer, search?: string, date_to?: string, statuses?: string[], date_from?: string, api_service?: string, next_cursor?: string, vendor_data?: string, session_kind?: string, workflow_ids?: string[], country_codes?: string[], warning_codes?: string[] }
- `POST https://api.mcp.ai/api/didit/list/workflows` — List configured verification workflow versions, their publication status, feature summary, and expected per-run pricing.
  - body: { limit?: integer, next_cursor?: string }

## Example prompts
- "What can I do in Didit?"
- "Show me a summary of my Didit account"

## More
- Page: https://mcp.ai/didit
- Agent spec (llms.txt): https://mcp.ai/didit/llms.txt
- Postman collection: https://mcp.ai/didit/postman.json