# Identitycheck — how to use (mcp.ai)

Connect your Identitycheck account and use 11 tools for security and identity straight from your AI agent. Connect with your own API key. IdentityCheck is a verification solution designed to authenticate user identities with precision and speed, utilizing advanced algorithms and comprehensive data sources to ensure accurate validation, mitigate fraud, and enhance security.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_identitycheck?ms=1787293500000`
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. `identitycheck_check_api_health`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/identitycheck`
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/identitycheck/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/identitycheck/check/api/health` — Performs an API health check to verify endpoint availability and responsiveness. This tool sends an HTTP request to a specified endpoint and interprets a 200 OK response as indicating the API is UP. I
  - body: { method?: string, endpoint_path?: string, include_raw_on_json?: boolean }
- `POST https://api.mcp.ai/api/identitycheck/delete/configuration` — Tool to delete an existing configuration. Use when you need to remove a configuration by its unique code.
  - body: { code: string }
- `POST https://api.mcp.ai/api/identitycheck/delete/notification/endpoint` — Tool to delete a notification endpoint by its unique code. This operation is idempotent - it will succeed whether the endpoint exists or has already been deleted. Use when you need to remove a callbac
  - body: { code: string }
- `POST https://api.mcp.ai/api/identitycheck/fetch/all/configurations` — Tool to fetch all existing configurations. Use when you need to list all customer configurations after authentication.
- `POST https://api.mcp.ai/api/identitycheck/fetch/all/notification/endpoints` — Fetches all configured notification endpoints (webhooks) for the IdentityCheck SDK. Use this to list all callback URLs that receive onboarding event notifications (START_ONBOARDING, END_ONBOARDING).
- `POST https://api.mcp.ai/api/identitycheck/fetch/configuration` — Fetch a specific identity verification configuration by its code. Use this action when you need to: - Retrieve theme customizations (logo, colors, button styles) for a configuration - Get custom wordi
  - body: { code: string }
- `POST https://api.mcp.ai/api/identitycheck/fetch/notification/endpoint` — Tool to fetch a notification endpoint by its code. Use when you need the current configuration of a specific callback endpoint.
  - body: { code: string }
- `POST https://api.mcp.ai/api/identitycheck/fetch/onboardings` — Retrieves identity verification onboarding sessions with comprehensive filtering and pagination. An onboarding represents a customer's identity verification journey, tracking their progress from link 
  - body: { uid?: string, page?: integer, dateTo?: string, status?: string, dateFrom?: string, errorCode?: string, businessUid?: string, notificationType?: string }
- `POST https://api.mcp.ai/api/identitycheck/get/document/content` — Tool to retrieve base64-encoded document content. Use when you have an onboarding UID and document code.
  - body: { uid: string, docCode: string }
- `POST https://api.mcp.ai/api/identitycheck/retrieve/onboarding/status` — Retrieve the current status and results of an identity verification onboarding session. Use this tool to check the progress of an onboarding (CREATED, CLICKED, CAPTURE_ONGOING) or get final results (S
  - body: { uid: string }
- `POST https://api.mcp.ai/api/identitycheck/update/configuration` — Tool to update an existing configuration. Use when you need to modify properties of a configuration identified by code.
  - body: { code: string, configuration: object }

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

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