Skip to main content
ON

Onfido

v0.2.1API Key

Líder global en KYC (de Entrust). Applicants, upload de documento, fotos en vivo, checks (documento + facial + watchlist + known-faces), reportes. Combina con Unico (BR-first) para cobertura global cuando el comercio toca usuarios fuera de LatAm.

20 herramientas2 env vars🌐 GLOBALestable en npm

Qué puede hacer tu agente

Onfido le da a tu agente 20 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.

  • create_applicantCreate an Onfido applicant — the person record that documents, live photos, and checks attach to. Required before any verification.
  • retrieve_applicantRetrieve an applicant by id.
  • update_applicantUpdate fields on an existing applicant. Send only the fields you want to change.
Ejemplo de llamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_applicant", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-onfido

Quickstart

Agregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "onfido": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-onfido"
      ],
      "env": {
        "ONFIDO_API_TOKEN": "<your_onfido_api_token>"
      }
    }
  }
}

Después de reiniciar, tu agente puede llamar cualquiera de las 20 herramientas de abajo — probá create_applicant primero.

Variables de entorno · 2

Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.

ONFIDO_API_TOKEN
obligatoriosecret

Onfido API token. Sent as 'Authorization: Token token=<value>'.

ONFIDO_REGION
opcional

Region for the API host: 'eu' (api.eu.onfido.com), 'us' (api.us.onfido.com), 'ca' (api.ca.onfido.com). Defaults to api.onfido.com when unset.

Herramientas disponibles · 20

Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.

WRITEcreate_applicant
Create an Onfido applicant — the person record that documents, live photos, and checks attach to. Required before any verification.
READretrieve_applicant
Retrieve an applicant by id.
WRITEupdate_applicant
Update fields on an existing applicant. Send only the fields you want to change.
READupload_document
Upload an identity document image for an applicant. Sent as multipart/form-data. Pass file as base64-encoded bytes plus file_name and content_type (image/jpeg, image/png, application/pdf).
READretrieve_document
Retrieve document metadata by id.
READupload_live_photo
Upload a live photo (selfie) for an applicant, used by facial_similarity_photo reports. Sent as multipart/form-data. NOTE: Onfido recommends capturing live photos via their SDK; direct API upload may be restricted on some accounts.
READretrieve_live_photo
Retrieve a live photo record by id.
WRITEcreate_check
Run a verification check on an applicant. A check is a bundle of one or more reports (document, facial_similarity_photo, watchlist, etc). This is the step that actually triggers the verification.

Frameworks compatibles

MCP es un protocolo — cualquier framework que lo hable puede montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Cualquier cliente MCPProtocolo

Preguntas frecuentes

Corré `npx -y @codespar/mcp-onfido` y agregá el bloque de config de arriba a tu cliente MCP — Claude, Cursor, VS Code o cualquier cliente compatible con MCP. Sin build, sin SDK. ¿Preferís hosted? El tier gestionado de CodeSpar lo corre por vos, con la auth resuelta.
Onfido — MCP server · 20 tools | CodeSpar