@codespar/mcp-certta
@codespar/mcp-certta
MCP server for Certta — Brazilian identity + signature platform. KYC/KYB (CPF / CNPJ via Receita Federal + SPC / Serasa), face match + liveness, OCR of RG / CNH / comprovantes, antifraud score, ICP-Brasil digital signature + GoCertta electronic signature, and orchestrated onboarding pipelines that chain KYC + biometrics + signature in one process.
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"certta": {
"command": "npx",
"args": ["@codespar/mcp-certta"],
"env": {
"CERTTA_API_KEY": "your-api-key"
}
}
}
}Cursor / VS Code
Same config in .cursor/mcp.json.
Tools (11)
KYC / KYB
| Tool | Certta endpoint | Notes |
|---|---|---|
kyc_lookup_cpf |
POST /v1/kyc/cpf |
CPF → name, DOB, regularity, restrictions, risk score |
kyb_lookup_cnpj |
POST /v1/kyb/cnpj |
CNPJ → corporate profile, QSA, CNAE, capital |
Biometrics
| Tool | Certta endpoint | Notes |
|---|---|---|
biometrics_face_match |
POST /v1/biometrics/face-match |
Selfie vs document photo + liveness |
biometrics_liveness |
POST /v1/biometrics/liveness |
Passive liveness on a selfie |
Documents + antifraud
| Tool | Certta endpoint | Notes |
|---|---|---|
documents_ocr |
POST /v1/documents/ocr |
OCR RG / CNH / CRLV / proof of residence / passport |
antifraud_score |
POST /v1/antifraud/score |
Composite risk score (0..100) |
Signature
| Tool | Certta endpoint | Notes |
|---|---|---|
signature_icp_create |
POST /v1/signature/icp/envelopes |
ICP-Brasil digital signature envelope |
signature_electronic_create |
POST /v1/signature/electronic/envelopes |
GoCertta electronic signature envelope |
signature_get_envelope |
GET /v1/signature/envelopes/{envelope_id} |
Status + signer responses |
Onboarding pipelines
| Tool | Certta endpoint | Notes |
|---|---|---|
onboarding_process_create |
POST /v1/onboarding/processes |
Orchestrate KYC + biometrics + signature in one flow |
onboarding_process_get |
GET /v1/onboarding/processes/{process_id} |
Per-step verdicts |
Authentication
Standard Bearer auth:
Authorization: Bearer <CERTTA_API_KEY>Issue your API key from the Certta dashboard:
- Production: https://certta.com.br
- Docs: https://docs.certta.com.br
Sandbox / Testing
Sandbox endpoint: https://api-sandbox.certta.com.br. Override via CERTTA_API_BASE.
Environment Variables
| Variable | Required | Description |
|---|---|---|
CERTTA_API_KEY |
yes | API key from the Certta dashboard |
CERTTA_API_BASE |
no | Override base URL (default https://api.certta.com.br) |
Certta vs Caf vs BigDataCorp
Three BR identity rails in this catalog, each with a different specialty:
| Provider | Strength | Best for |
|---|---|---|
| Certta | KYC + biometrics + ICP-Brasil signature | Onboarding with signed contracts |
Caf (@codespar/mcp-caf) |
KYC + Trust Platform orchestration | Hosted onboarding with policy rules |
BigDataCorp (@codespar/mcp-bigdatacorp) |
Broad data enrichment + antifraud | KYC + AML + credit decisioning |
Enterprise
Need governance, budget limits, and audit trails for agent identity calls? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT