Skip to main content
ON

Onfido

v0.2.1API Key

Líder global em KYC (da Entrust). Applicants, upload de documento, fotos ao vivo, checks (documento + facial + watchlist + known-faces), relatórios. Combina com a Unico (BR-first) pra cobertura global quando o comércio toca usuários fora da LatAm.

20 ferramentas2 env vars🌐 GLOBALestável no npm

O que seu agente faz

O Onfido dá ao seu agente 20 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer 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.
Exemplo de chamada
// 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

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).

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

Depois de reiniciar, seu agente pode chamar qualquer uma das 20 ferramentas abaixo — teste create_applicant primeiro.

Variáveis de ambiente · 2

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

ONFIDO_API_TOKEN
obrigatóriosecret

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.

Ferramentas disponíveis · 20

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

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 compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

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

Perguntas frequentes

Rode `npx -y @codespar/mcp-onfido` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
Onfido — MCP server · 20 tools | CodeSpar