@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