{"_id":"@codespar/mcp-unico","_rev":"5-5967d76a6234007abbc00076e753041e","name":"@codespar/mcp-unico","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0-alpha.1":{"name":"@codespar/mcp-unico","version":"0.1.0-alpha.1","keywords":["mcp","unico","identity","kyc","cpf","cnpj","biometrics","liveness","pep","brazil"],"license":"MIT","_id":"@codespar/mcp-unico@0.1.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-unico":"dist/index.js"},"dist":{"shasum":"980036fb24049e9ab181092576b232e00c110ece","tarball":"https://registry.npmjs.org/@codespar/mcp-unico/-/mcp-unico-0.1.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-bykwVrrblCoPyA3WAf/f9pT8P0gT3gVhz9zPTeEt6DsZB/djC8mhU0xWf8YaedJn836T1NCALsX2ubMxrBJdcA==","signatures":[{"sig":"MEUCIGKBZsi4gZFRPCvo1dukyq9M0sIEnSQGx5431YcrDZJrAiEA2R9jWGFEtM38L7tFzl3z2TFaIzJJc6XsSG5cuOEx1z0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37871},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"26b185ffb621230aec45ba62ad8f5d59b30cd44a","mcpName":"io.github.codespar/mcp-unico","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Unico — Brazilian identity verification & KYC (IDCloud, IDPay, IDCheck). CPF/CNPJ validation, document OCR, face match, liveness, PEP/watchlists.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-unico_0.1.0-alpha.1_1776995747527_0.8101183266116734","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-unico","version":"0.2.0-alpha.1","keywords":["mcp","unico","identity","kyc","cpf","cnpj","biometrics","liveness","pep","brazil"],"license":"MIT","_id":"@codespar/mcp-unico@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-unico":"dist/index.js"},"dist":{"shasum":"cc3d9dee6b3b3e2ee73613ac02d894fe9f35e32c","tarball":"https://registry.npmjs.org/@codespar/mcp-unico/-/mcp-unico-0.2.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-q8pOOEbkI3P6ca5zcF/fNqVmz5wi5Q8PB120W46zvIzzNJL10CjUCJuYy0tKUtoU6mS/tVdXddSrWAxy4XTRhQ==","signatures":[{"sig":"MEQCIHdZgSwQ5YbUE+AwnCaZNGeMPUefNorYmsaJK3Y9hJv/AiBdOjAuZ6YUofJJkeXCeNDlXT5RbCeNRKz38Oh0ysKChw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56455},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"16948c85b03c82fa9da581a7a3e62981ce6e211e","mcpName":"io.github.codespar/mcp-unico","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Unico — Brazilian identity verification & KYC (IDCloud, IDPay, IDCheck, Sign). CPF/CNPJ, document OCR, face match, liveness, PEP/watchlists, processes, webhooks, Unico Score.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-unico_0.2.0-alpha.1_1777117987555_0.44253538613505805","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-unico","version":"0.2.0-alpha.2","keywords":["mcp","unico","identity","kyc","cpf","cnpj","biometrics","liveness","pep","brazil"],"license":"MIT","_id":"@codespar/mcp-unico@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-unico":"dist/index.js"},"dist":{"shasum":"0056eac1a830da6c4be74f2abd5db786521218e8","tarball":"https://registry.npmjs.org/@codespar/mcp-unico/-/mcp-unico-0.2.0-alpha.2.tgz","fileCount":6,"integrity":"sha512-U2ESR6VxORuqhxSCRTLMYsou0UdSE7qKoR2gvyPDCezV4J/dy1mBD3xuJXVmKunysUtsOA4Y8p3qzoVw9NOiLQ==","signatures":[{"sig":"MEQCIH3lTfSsW0lqhuGhWH/+L26O1skubA5IYgdDG7sSpDUaAiBLKcjKgrS8LfpcoXZF1CETyDplv/fCVnzYofRTdJyiKg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57394},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-unico","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Unico — Brazilian identity verification & KYC (IDCloud, IDPay, IDCheck, Sign). CPF/CNPJ, document OCR, face match, liveness, PEP/watchlists, processes, webhooks, Unico Score.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-unico_0.2.0-alpha.2_1777123124455_0.35273212931311293","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-unico","version":"0.2.0-alpha.3","description":"MCP server for Unico — Brazilian identity verification & KYC (IDCloud, IDPay, IDCheck, Sign). CPF/CNPJ, document OCR, face match, liveness, PEP/watchlists, processes, webhooks, Unico Score.","type":"module","main":"./dist/index.js","bin":{"mcp-unico":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","unico","identity","kyc","cpf","cnpj","biometrics","liveness","pep","brazil"],"mcpName":"io.github.codespar/mcp-unico","_id":"@codespar/mcp-unico@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-U/wveHQEPu29cVyTXnX9zKHkcFc/drbca1ldGpFwGxWvkipKLfVsN2aGrFYbe8x7NXEjisQ5hKLYaVg6HDLSkg==","shasum":"6462f5dab6ad02856059dd8cc5c2901348b06899","tarball":"https://registry.npmjs.org/@codespar/mcp-unico/-/mcp-unico-0.2.0-alpha.3.tgz","fileCount":6,"unpackedSize":58789,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD9sBIPFRgTzwH24NHkqeSUFgkP7k4wd2YpGuLj0lAONQIhALmGOB1PCJM3WvxlBGVLlDGiEjKpu0AsQhfFKDcWYoBn"}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-unico_0.2.0-alpha.3_1782153713951_0.0824612398713096"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T01:55:47.409Z","modified":"2026-06-22T18:41:54.292Z","0.1.0-alpha.1":"2026-04-24T01:55:47.673Z","0.2.0-alpha.1":"2026-04-25T11:53:07.700Z","0.2.0-alpha.2":"2026-04-25T13:18:44.605Z","0.2.0-alpha.3":"2026-06-22T18:41:54.117Z"},"license":"MIT","keywords":["mcp","unico","identity","kyc","cpf","cnpj","biometrics","liveness","pep","brazil"],"description":"MCP server for Unico — Brazilian identity verification & KYC (IDCloud, IDPay, IDCheck, Sign). CPF/CNPJ, document OCR, face match, liveness, PEP/watchlists, processes, webhooks, Unico Score.","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-unico\n\nMCP server for [Unico](https://unico.io) — the Brazilian identity verification leader. CPF/CNPJ validation, document OCR, face biometrics, liveness, PEP / watchlist / court-records screening.\n\nFirst entry in the CodeSpar `identity` category. Commerce agents onboarding sellers (marketplaces), running high-value transactions, or operating KYC-regulated flows need identity verification — Unico is the BR standard. Paired with [`@codespar/mcp-onfido`](../onfido) for BR-first + global coverage.\n\n## Products\n\nUnico sells three separately-contracted products. This server exposes tools for all three; agents should call only what's enabled on your contract (disabled products return 403).\n\n| Product  | What it does                                                            |\n|----------|-------------------------------------------------------------------------|\n| IDCloud  | CPF/CNPJ validation with Receita Federal, document OCR, authenticity    |\n| IDPay    | Face match + liveness for login and payment authentication              |\n| IDCheck  | PEP, sanctions watchlists, Brazilian court records                      |\n\n## Tools (18)\n\n| Tool | Purpose |\n|---|---|\n| `validate_cpf` | IDCloud: validate a Brazilian CPF with Receita Federal. |\n| `validate_cnpj` | IDCloud: validate a Brazilian CNPJ with Receita Federal. |\n| `extract_document` | IDCloud: OCR + structured field extraction from a Brazilian ID document image. |\n| `verify_document_authenticity` | IDCloud: tamper / forgery detection on a document image. |\n| `face_match` | IDPay: biometric 1:1 comparison between a live selfie and a document photo. |\n| `liveness_check` | IDPay: passive liveness detection. |\n| `check_pep` | IDCheck: Politically Exposed Person screening. |\n| `check_watchlists` | IDCheck: global sanctions / adverse-media screening. |\n| `court_records_search` | IDCheck: Brazilian judicial-records search. |\n| `get_process_status` | IDCheck: poll the status of a verification process previously created via the Unico Web/Mobile SDK or API. |\n| `batch_get_process_status` | IDCheck: batch status lookup. |\n| `upload_process_document` | IDCheck: upload a captured image to a running verification process. |\n| `get_extracted_data` | IDCheck: fetch the structured OCR result for a finished process — typed fields (name, document number, issu... |\n| `get_unico_score` | IDCheck: Unico Score — Brazil's identity-fraud risk score (0-1000, higher = lower risk) computed from Unico... |\n| `connect_portability_check` | Connect: cross-tenant portability check. |\n| `register_webhook` | Webhooks: subscribe a callback URL to receive Unico process events (process.created, process.finished, proc... |\n| `list_webhooks` | Webhooks: list all webhook subscriptions registered for this tenant. |\n| `delete_webhook` | Webhooks: remove a webhook subscription. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-unico@alpha\n```\n\n## Environment\n\n```bash\nUNICO_CLIENT_ID=\"...\"       # OAuth client_id\nUNICO_CLIENT_SECRET=\"...\"   # OAuth client_secret\nUNICO_ENV=\"sandbox\"         # Optional. 'sandbox' | 'production'. Default: sandbox\nUNICO_BASE_URL=\"...\"        # Optional. Default: https://api.unico.co\nUNICO_AUTH_URL=\"...\"        # Optional. Default: https://auth.unico.co\n```\n\n## Authentication\n\nOAuth 2.0 Client Credentials. The server posts `client_id:client_secret` as Basic auth to Unico's token endpoint and caches the bearer token in memory until 60 s before expiry. Unico's docs require server-side integration only — never expose these credentials to a browser or mobile client.\n\n## Run\n\n```bash\n# stdio (default)\nnpx @codespar/mcp-unico\n\n# HTTP\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-unico\n```\n\n## Status\n\nShipped as `0.1.0-alpha.1`. Unico's REST contract lives behind the [devcenter.unico.io](https://devcenter.unico.io) portal and is gated by merchant account. Tool names and argument shapes are stable, but exact endpoint paths may shift once we validate against live credentials — override `UNICO_BASE_URL` / `UNICO_AUTH_URL` if your account is served from a different host. PRs welcome once you've seen the real payloads.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}