# mcp-caf

This MCP server exposes KYC/KYB, biometrics, document OCR, and Trust Platform flows. Its default service host currently fails DNS resolution.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/identity/caf
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-caf

## What it does

mcp-caf gives an agent tools for checking people and companies, validating identity documents, comparing a selfie with a reference image, and running passive liveness checks. Its nine tools also start and inspect Trust Platform onboarding flows, list account data sources, and fetch an earlier check by ID.

The server expects `CAF_API_KEY` for Bearer authentication. `CAF_API_BASE` can point it to another API base, including the sandbox address described by the package. The package is deprecated: `api.caf.io` does not resolve in DNS, so requests sent to the default host do not reach a service. A functioning endpoint must be confirmed first.

Install it with `npx -y @codespar/mcp-caf`; setup commands are provided for Codex, Cursor, GitHub Copilot, and Gemini CLI as well. Claude Code uses `claude mcp add` with the API key in an environment variable.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CAF_API_KEY`, `CAF_API_BASE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env CAF_API_KEY=<CAF_API_KEY> --env CAF_API_BASE=<CAF_API_BASE> --transport stdio caf -- npx -y @codespar/mcp-caf
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add caf --env CAF_API_KEY=<CAF_API_KEY> --env CAF_API_BASE=<CAF_API_BASE> -- npx -y @codespar/mcp-caf
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "caf": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-caf"
            ],
            "env": {
                "CAF_API_KEY": "<CAF_API_KEY>",
                "CAF_API_BASE": "<CAF_API_BASE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "caf": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-caf"
            ],
            "env": {
                "CAF_API_KEY": "<CAF_API_KEY>",
                "CAF_API_BASE": "<CAF_API_BASE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CAF_API_KEY=<CAF_API_KEY> -e CAF_API_BASE=<CAF_API_BASE> caf npx -y @codespar/mcp-caf
```
Replace <…> with your own values

## When to use it
- check a person by CPF
- screen a company by CNPJ
- compare a selfie with a reference image
- extract and validate document data
- start a Trust Platform onboarding flow

## Example prompts
- Ask the agent to run `person_check` for this CPF and return the risk result.
- Use `company_check` for this CNPJ and show the company profile and sanctions.
- Run `document_check` on this document and report its OCR and authenticity result.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md