Skip to main content
UN

Unico

v0.2.0-alpha.2OAuth2alpha

Líder brasileira em verificação de identidade / KYC. IDCloud (CPF/CNPJ + OCR de documento), IDPay (face match, liveness), IDCheck (PEP, sanções, registros judiciais). Primeira entrada na categoria Identidade e KYC. Alpha no npm — devcenter.unico.io é fechado por contrato; base URLs sobrescrevíveis via env.

18 ferramentas5 env vars🇧🇷 Brasilalpha — validação pendente

O que seu agente faz

O Unico dá ao seu agente 18 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer 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.
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("validate_cpf", { /* ... */ });

Instalar

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

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

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

Variáveis de ambiente · 5

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

UNICO_CLIENT_ID
obrigatório

Unico OAuth client_id

UNICO_CLIENT_SECRET
obrigatóriosecret

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.

Ferramentas disponíveis · 18

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

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