io.github.codespar/mcp-unico
NPM · @CODESPAR/MCP-UNICO · SCANNED AUG 4
MCP server for Unico — Brazilian identity + KYC: CPF/CNPJ, OCR, face match, liveness, PEP/watchlists
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security86
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 42 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability74
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 1850 tokens (~102/item across 18 items; 18 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management30
- Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @codespar/mcp-unico
claude mcp add codespar-mcp-unico -- npx -y @codespar/mcp-unico
codex mcp add codespar-mcp-unico -- npx -y @codespar/mcp-unico
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"codespar-mcp-unico": {
"type": "local",
"command": [
"npx",
"-y",
"@codespar/mcp-unico"
],
"enabled": true
}
}
} openclaw mcp add codespar-mcp-unico --command npx --arg -y --arg @codespar/mcp-unico
mcp_servers:
codespar-mcp-unico:
command: "npx"
args: ["-y", "@codespar/mcp-unico"] {
"mcpServers": {
"codespar-mcp-unico": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-unico"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 2 Aug 26 +32
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Tool coverage: 100 → unverified ▼ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Schema quality: unverified → good ▲ functional
- Dependency health: unverified → partial ▲ functional
- Licence: MIT functional
- 1 Aug 26 +29
- Malware scan: unverified → pass ▲ security
- Dependency health: partial → unverified ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- 31 Jul 26 −21
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 27 Jul 26 46
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 4 Aug 2026 · Analysed npm/@codespar/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 94 packages
94 packages in the resolved dependency tree · 94 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
batch_get_process_status ~80
IDCheck: batch status lookup. Send up to 100 process_ids per call and receive the same status payload as get_process_status for each. Use this for nightly reconciliation jobs or backfill, not for hot-path polling.
| Name | Type | Req | Description |
|---|---|---|---|
| process_ids | array | yes | Array of Unico process_ids (max 100). Order is preserved in the response. |
No output schema declared.
No examples provided.
check_pep ~106
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cpf | string | — | CPF digits only. Preferred for precise matching. |
| name | string | — | Full name. Use when CPF is unavailable; fuzzy-matched. |
No output schema declared.
No examples provided.
check_watchlists ~103
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.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | — | Optional ISO-3166 alpha-2 country code to scope results |
| cpf | string | — | CPF digits only |
| name | string | — | Full name |
No output schema declared.
No examples provided.
connect_portability_check ~119
Connect: cross-tenant portability check. Asks Unico's network whether the given CPF has already completed a high-assurance verification at another participating tenant within the lookback window. Lets you skip a full KYC re-capture when a prior verification is recent enough. Returns { has_prior_verification, last_verified_at, assurance_level, source_anonymized_id }.
| Name | Type | Req | Description |
|---|---|---|---|
| cpf | string | yes | CPF digits only |
| max_age_days | number | — | Optional. Reject prior verifications older than this many days (default 90). |
No output schema declared.
No examples provided.
court_records_search ~121
IDCheck: Brazilian judicial-records search. Covers federal and state courts (TRFs, TJs), labor courts (TRTs), and superior courts (STJ, STF). Returns case list with court, class, status, and filing date. Compliance-grade, not for scraping.
| Name | Type | Req | Description |
|---|---|---|---|
| cnpj | string | — | CNPJ digits only (for legal entities) |
| cpf | string | — | CPF digits only (for individuals) |
| name | string | — | Full name or razão social |
| scope | string | — | Court-system scope (default: all) |
No output schema declared.
No examples provided.
delete_webhook ~49
Webhooks: remove a webhook subscription. Idempotent — deleting an unknown id returns 204.
| Name | Type | Req | Description |
|---|---|---|---|
| webhook_id | string | yes | The webhook_id returned by register_webhook / list_webhooks. |
No output schema declared.
No examples provided.
extract_document ~136
IDCloud: OCR + structured field extraction from a Brazilian ID document image. Returns typed fields (name, document number, issuer, birthdate, parents, etc.) plus extraction confidence.
| Name | Type | Req | Description |
|---|---|---|---|
| document_type | string | yes | Document type. RG = Registro Geral, CNH = driver's license, RNE = resident foreign national, CTPS = work card. |
| image_back_base64 | string | — | Optional base64-encoded image of the document back (required for CNH and some RG variants). |
| image_base64 | string | yes | Base64-encoded document image (front; back via image_back_base64). JPEG or PNG. |
No output schema declared.
No examples provided.
face_match ~91
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.
| Name | Type | Req | Description |
|---|---|---|---|
| document_image_base64 | string | yes | Base64-encoded document photo (or a cropped face region from a document) |
| selfie_image_base64 | string | yes | Base64-encoded live selfie image |
No output schema declared.
No examples provided.
get_extracted_data ~77
IDCheck: fetch the structured OCR result for a finished process — typed fields (name, document number, issuer, birthdate, etc.) plus per-field confidence and the raw text blocks. Returns 409 if the process has not yet reached FINISHED.
| Name | Type | Req | Description |
|---|---|---|---|
| process_id | string | yes | Verification process_id whose OCR output you want. |
No output schema declared.
No examples provided.
get_process_status ~106
IDCheck: poll the status of a verification process previously created via the Unico Web/Mobile SDK or API. Returns { status (CREATED | IN_PROGRESS | FINISHED | EXPIRED | CANCELED), verdict, finished_at, score, reasons[] }. Use this to drive your KYC state machine after the user finishes the SDK capture flow.
| Name | Type | Req | Description |
|---|---|---|---|
| process_id | string | yes | The process identifier returned by Unico when the verification was created (also called id_processo). |
No output schema declared.
No examples provided.
get_unico_score ~101
IDCheck: Unico Score — Brazil's identity-fraud risk score (0-1000, higher = lower risk) computed from Unico's cross-tenant graph of biometric and document events. Returns { score, band (VERY_LOW | LOW | MEDIUM | HIGH | VERY_HIGH), reasons[], computed_at }. Score availability requires a Score-tier contract.
| Name | Type | Req | Description |
|---|---|---|---|
| cpf | string | yes | CPF digits only or formatted XXX.XXX.XXX-XX |
No output schema declared.
No examples provided.
list_webhooks ~40
Webhooks: list all webhook subscriptions registered for this tenant. Returns each webhook's id, url, subscribed events, created_at, and last_delivery_status.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
liveness_check ~96
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[] }.
| Name | Type | Req | Description |
|---|---|---|---|
| image_base64 | string | — | Base64-encoded still image (passive liveness) |
| video_base64 | string | — | Optional base64-encoded short video for active/challenge-based liveness |
No output schema declared.
No examples provided.
register_webhook ~127
Webhooks: subscribe a callback URL to receive Unico process events (process.created, process.finished, process.expired, score.updated). Returns the webhook_id to use with delete_webhook. The endpoint must be HTTPS and respond 2xx within 10 s.
| Name | Type | Req | Description |
|---|---|---|---|
| events | array | — | Event types to subscribe to. Defaults to all if omitted. |
| secret | string | — | Optional shared secret. Unico will sign each delivery with HMAC-SHA256 in the X-Unico-Signature header. |
| url | string | yes | HTTPS callback URL (must be publicly reachable). |
No output schema declared.
No examples provided.
upload_process_document ~128
IDCheck: upload a captured image to a running verification process. Use the appropriate document_side (FRONT, BACK, SELFIE) to match the process template. The image is consumed by Unico's OCR + biometric pipeline; results show up via get_process_status / get_extracted_data once processing finishes.
| Name | Type | Req | Description |
|---|---|---|---|
| document_side | string | yes | Which slot this image fills: document front, document back, or selfie capture. |
| image_base64 | string | yes | Base64-encoded JPEG/PNG image (max 8 MB). |
| process_id | string | yes | Target verification process_id |
No output schema declared.
No examples provided.
validate_cnpj ~86
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cnpj | string | yes | CNPJ digits only (14 chars) or formatted XX.XXX.XXX/XXXX-XX |
No output schema declared.
No examples provided.
validate_cpf ~116
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.
| Name | Type | Req | Description |
|---|---|---|---|
| birthdate | string | — | Optional. ISO-8601 date (YYYY-MM-DD) to cross-check against RF records |
| cpf | string | yes | CPF digits only (11 chars) or formatted XXX.XXX.XXX-XX |
No output schema declared.
No examples provided.
verify_document_authenticity ~101
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).
| Name | Type | Req | Description |
|---|---|---|---|
| image_base64 | string | yes | Base64-encoded document image |
| type | string | yes | Document type being verified |
No output schema declared.
No examples provided.