io.github.codespar/mcp-certta (Model Context Protocol) Server

The io.github.codespar/mcp-certta MCP server for Certta provides tools for Brazilian KYC/KYB and onboarding. It supports identity verification flows including CPF/CNPJ checks via Receita Federal and credit bureau data (SPC/Serasa), biometrics for face match and liveness, and OCR for RG/CNH documents and proof-of-address files.

🛠️ Key Features

KYC/KYB for Brazilian identities (CPF / CNPJ)
Biometrics: face match and liveness
OCR for RG / CNH / comprovantes
Antifraud score
ICP-Brasil digital signature and GoCertta electronic signature
Orchestrated onboarding pipelines chaining KYC + biometrics + signature

🚀 Use Cases

Identity verification during customer onboarding in Brazil
Document OCR extraction for RG/CNH and address proofs
Signature-based onboarding using ICP-Brasil and GoCertta

⚡ Developer Benefits

Single MCP server to chain KYC, biometrics, and signature in one process
Includes integration guidance for Claude Desktop via claude_desktop_config.json

⚠️ Limitations

Available details are limited to KYC/KYB, OCR, antifraud scoring, signatures, and onboarding orchestration; tool count is not provided.

@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:

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:

code

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

io.github.codespar/mcp-certta