About mcp-certta
mcp-certta is a deprecated MCP server whose target host, api.certta.com.br, does not resolve, so no tool reaches a service. The package remains in the repository for reference only. It was designed for Brazilian identity checks and digital signature, including KYC/KYB, face match, OCR and ICP-Brasil signing.
Key features
- 01CPF and CNPJ KYC/KYB lookups
- 02Face match and liveness detection
- 03OCR for RG, CNH and other documents
- 04ICP-Brasil and GoCertta signature envelopes
- 05Orchestrated onboarding processes
Use cases
- 01Reviewing the interface design for a new identity verification integration
- 02Re-enabling the server by setting CERTTA_BASE_URL to a working endpoint
MCP support
The server was designed to expose 11 identity and signature tools to MCP clients, but none currently reach a live service.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-certtaCERTTA_API_KEYSecretAPI key from the Certta dashboardCERTTA_API_BASEAPI base URL — defaults to Certta production. Override for sandbox.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
11Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| cpf | string | Yes | 11-digit CPF, with or without punctuation |
| birth_date | string | No | YYYY-MM-DD (some Receita queries require for cross-check) |
Details
From the project README@codespar/mcp-certta
Deprecated: no live endpoint. Measured on 2026-09-27 against two public DNS resolvers (8.8.8.8 and 1.1.1.1):
api.certta.com.br, the host this server calls, does not resolve in DNS.docs.certta.airedirects to CAF's documentation (Certta is CAF's current brand), which namesapi.combateafraude.com/v1(Core API, not recommended for new integrations) andapi.us.prd.caf.io(Connect API); this server was not written against either and has not been checked. See also@codespar/mcp-caf. No tool in this server reaches a service. The package is deprecated on npm and stays in this repository for reference only. If you have a working endpoint, point the server at it withCERTTA_BASE_URL. To bring the package back, open an issue in mcp-dev-latam with the provider's documented base URL.
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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.