Skip to main content
UN

Unico

v0.2.0-alpha.2OAuth2alpha

Líder brasileña en verificación de identidad / KYC. IDCloud (CPF/CNPJ + OCR de documento), IDPay (face match, liveness), IDCheck (PEP, sanciones, registros judiciales). Primera entrada en la categoría Identidad y KYC. Alpha en npm — devcenter.unico.io está cerrado por contrato; base URLs sobrescribibles vía env.

18 herramientas5 env vars🇧🇷 Brasilalpha — validación pendiente

Qué puede hacer tu agente

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

  • validate_cpfIDCloud: validate a Brazilian CPF with Receita Federal. Returns { valid, status (REGULAR | SUSPENSA | TITULAR FALECIDO | CANCELADA | NULA | PENDENTE), name, situation }. Optional birthdate enables a cross-check against the CPF registry.
  • validate_cnpjIDCloud: validate a Brazilian CNPJ with Receita Federal. Returns company status (ATIVA, BAIXADA, SUSPENSA, INAPTA), legal name, trade name, partners (QSA), address, and primary CNAE.
  • extract_documentIDCloud: OCR + structured field extraction from a Brazilian ID document image. Returns typed fields (name, document number, issuer, birthdate, parents, etc.) plus extraction confidence.
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("validate_cpf", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-unico@alpha

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": {
    "unico": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-unico@alpha"
      ],
      "env": {
        "UNICO_CLIENT_ID": "<your_unico_client_id>",
        "UNICO_CLIENT_SECRET": "<your_unico_client_secret>"
      }
    }
  }
}

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

Variables de entorno · 5

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

UNICO_CLIENT_ID
obligatorio

Unico OAuth client_id

UNICO_CLIENT_SECRET
obligatoriosecret

Unico OAuth client_secret

UNICO_ENV
opcional

Environment: 'sandbox' or 'production'. Defaults to 'sandbox'.

UNICO_BASE_URL
opcional

Optional override for the IDCloud/IDPay/IDCheck API base URL. Defaults to https://api.unico.co.

UNICO_AUTH_URL
opcional

Optional override for the OAuth token endpoint base URL. Defaults to https://auth.unico.co.

Herramientas disponibles · 18

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

WRITEvalidate_cpf
IDCloud: validate a Brazilian CPF with Receita Federal. Returns { valid, status (REGULAR | SUSPENSA | TITULAR FALECIDO | CANCELADA | NULA | PENDENTE), name, situation }. Optional birthdate enables a cross-check against the CPF registry.
WRITEvalidate_cnpj
IDCloud: validate a Brazilian CNPJ with Receita Federal. Returns company status (ATIVA, BAIXADA, SUSPENSA, INAPTA), legal name, trade name, partners (QSA), address, and primary CNAE.
READextract_document
IDCloud: OCR + structured field extraction from a Brazilian ID document image. Returns typed fields (name, document number, issuer, birthdate, parents, etc.) plus extraction confidence.
READverify_document_authenticity
IDCloud: tamper / forgery detection on a document image. Returns an authenticity score (0-1), a categorical verdict (AUTHENTIC | SUSPICIOUS | FRAUDULENT), and a list of detected anomalies (e.g. font mismatch, copy-paste edits, printed-on-screen capture).
READface_match
IDPay: biometric 1:1 comparison between a live selfie and a document photo. Returns a similarity score (0-1) and a boolean match verdict at Unico's production-tuned threshold.
READliveness_check
IDPay: passive liveness detection. Confirms the captured subject is a physically present person, not a printed photo, screen replay, mask, or deepfake. Returns { is_live, score, signals[] }.
READcheck_pep
IDCheck: Politically Exposed Person screening. Pass cpf (preferred) or name; returns matches with role, jurisdiction, and source. A subject is PEP if they currently hold — or held in the last 5 years — a prominent public function per Bacen Circular 3,978/2020.
READcheck_watchlists
IDCheck: global sanctions / adverse-media screening. Covers OFAC (US Treasury), UN, EU, HMT (UK), Interpol Red Notices, and curated adverse-media sources. Pass cpf or name; returns hits with list name, entry date, and risk level.

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-unico` 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.
Unico — MCP server · 18 tools | CodeSpar