io.github.codespar/mcp-caf Model Context Protocol (MCP) Server

This MCP server provides integrations for Caf, a Brazilian identity and trust platform. It supports KYC/KYB for orchestrated onboarding, including face authentication with liveness checks, document validation, and document OCR, plus policy-rule chaining for multi-step identity verifications.

🛠️ Key Features

KYC/KYB capabilities
Face authentication and liveness
Document validation
Document OCR
Orchestrated onboarding flows
Multi-step identity verification with policy rules

🚀 Use Cases

Brazilian onboarding requiring identity verification
Document-based identity checks via OCR
Automated onboarding workflows that chain multiple verification steps
Identity verification for fintech and payments contexts

⚡ Developer Benefits

MCP integration targeted at Claude Desktop and Cursor/VS Code setups
Configurable runtime via CAF_API_KEY environment variable
Tooling centered on identity verification primitives (face auth, liveness, OCR)

⚠️ Limitations

The provided documentation excerpt does not list available MCP tools or detailed configuration beyond the Claude Desktop example.

Tools (9)

KYC / KYB

Tool

Caf endpoint

Notes

person_check

POST /v1/checks/person

CPF → name, DOB, restrictions, risk

company_check

POST /v1/checks/company

CNPJ → profile, QSA, sanctions

Biometrics

Tool

Caf endpoint

Notes

face_authentication

POST /v1/biometrics/face

Selfie vs base image + liveness

liveness_check

POST /v1/biometrics/liveness

Passive liveness only

Documents

Tool

Caf endpoint

Notes

document_check

POST /v1/checks/document

OCR + authenticity for RG / CNH / passport / proof of residence

Trust Platform orchestration

Tool

Caf endpoint

Notes

trust_platform_start

POST /v1/trust/flows

Hosted onboarding flow per dashboard template

trust_platform_get

GET /v1/trust/flows/{flow_id}

Per-step verdicts

Metadata + replay

Tool

Caf endpoint

Notes

list_datasources

GET /v1/datasources

Datasources enabled on your account

get_check_result

GET /v1/checks/{check_id}

Replay a previous check by id

Variable

Required

Description

CAF_API_KEY

yes

API key from the Caf dashboard

CAF_API_BASE

Override base URL (default https://api.caf.io)

Caf vs Certta vs BigDataCorp

Three BR identity rails in this catalog, each with a different specialty:

Provider

Strength

Best for

Caf

KYC + Trust Platform orchestration

Hosted onboarding with policy rules

Certta (@codespar/mcp-certta)

KYC + biometrics + ICP-Brasil signature

Onboarding with signed contracts

BigDataCorp (@codespar/mcp-bigdatacorp)

Broad data enrichment + antifraud

KYC + AML + credit decisioning

Install

Configuration

Environment variables

CAF_API_KEYrequiredsecret

API key from the Caf dashboard

CAF_API_BASE

API base URL — defaults to Caf production. Override for sandbox.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-caf": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-caf@0.1.2"
      ],
      "env": {
        "CAF_API_KEY": "<YOUR_CAF_API_KEY>",
        "CAF_API_BASE": "<YOUR_CAF_API_BASE>"
      }
    }
  }
}

io.github.codespar/mcp-caf