# mcp-unico

Adds Unico verification tools to your agent: CPF/CNPJ checks, document OCR, face matching, PEP and court-record screening. The default endpoint no longer resolves, so it only runs against your own URL.

- 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/unico
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-unico

## What it does

The npm package is `@codespar/mcp-unico`. It wraps three Unico products: IDCloud (CPF and CNPJ validation, document field extraction, forgery detection), IDPay (selfie-to-document face comparison and liveness) and IDCheck (PEP, sanctions, Brazilian court records, Unico Score). Webhook management and process status polling come with it. Calling a tool your contract does not cover returns 403.

The server is dead out of the box. At the time of the check neither `api.unico.co` nor `auth.unico.co` resolved in DNS, and Unico's current hosts are different ones this code was never written against. The package sits deprecated on npm for reference. Without your own `UNICO_BASE_URL` and `UNICO_AUTH_URL` nothing will connect.

Auth is OAuth 2.0 Client Credentials, so bring `UNICO_CLIENT_ID` and `UNICO_CLIENT_SECRET`; the bearer token is cached in memory. Credentials belong on the server only, never in a browser or mobile client. Run it with `npx`, stdio by default, or switch to HTTP with `MCP_HTTP=true` and `MCP_PORT`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `UNICO_CLIENT_ID`, `UNICO_CLIENT_SECRET`, `UNICO_ENV`, `UNICO_BASE_URL`, `UNICO_AUTH_URL` — 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 UNICO_CLIENT_ID=<UNICO_CLIENT_ID> --env UNICO_CLIENT_SECRET=<UNICO_CLIENT_SECRET> --env UNICO_ENV=<UNICO_ENV> --env UNICO_BASE_URL=<UNICO_BASE_URL> --env UNICO_AUTH_URL=<UNICO_AUTH_URL> --transport stdio unico -- npx -y @codespar/mcp-unico
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add unico --env UNICO_CLIENT_ID=<UNICO_CLIENT_ID> --env UNICO_CLIENT_SECRET=<UNICO_CLIENT_SECRET> --env UNICO_ENV=<UNICO_ENV> --env UNICO_BASE_URL=<UNICO_BASE_URL> --env UNICO_AUTH_URL=<UNICO_AUTH_URL> -- npx -y @codespar/mcp-unico
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unico": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-unico"
            ],
            "env": {
                "UNICO_CLIENT_ID": "<UNICO_CLIENT_ID>",
                "UNICO_CLIENT_SECRET": "<UNICO_CLIENT_SECRET>",
                "UNICO_ENV": "<UNICO_ENV>",
                "UNICO_BASE_URL": "<UNICO_BASE_URL>",
                "UNICO_AUTH_URL": "<UNICO_AUTH_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e UNICO_CLIENT_ID=<UNICO_CLIENT_ID> -e UNICO_CLIENT_SECRET=<UNICO_CLIENT_SECRET> -e UNICO_ENV=<UNICO_ENV> -e UNICO_BASE_URL=<UNICO_BASE_URL> -e UNICO_AUTH_URL=<UNICO_AUTH_URL> unico npx -y @codespar/mcp-unico
```
Replace <…> with your own values

## When to use it
- validate a CPF or CNPJ against Receita Federal
- pull typed fields out of a Brazilian ID photo
- match a selfie to the photo on a document
- screen a customer for PEP and sanctions hits
- subscribe a callback URL to verification events

## Example prompts
- Check the CPF in this application and show the Receita Federal result
- Run OCR on `docs/rg.jpg` and dump the extracted fields as JSON
- Compare `selfie.jpg` with the passport photo and run a liveness check

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12109
- [Robin: AI-Powered Dark Web OSINT](https://affpapa.org/en/nevibecode/mcp/robin-ai-powered-dark-web-osint.md) — MCP server · ★ 7658
- [jshookmcp](https://affpapa.org/en/nevibecode/mcp/jshookmcp.md) — MCP server · ★ 2061
- [OpenOSINT](https://affpapa.org/en/nevibecode/mcp/openosint.md) — MCP server · ★ 1802

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