mcp-certta — Claude Code MCP server: features and setup
This MCP server exposes Certta identity checks, biometrics, document OCR, fraud scoring, and signature tools to an agent. Its API host currently does not resolve, so the tools cannot reach a service.
claude mcp add --env CERTTA_API_KEY=<CERTTA_API_KEY> --env CERTTA_API_BASE=<CERTTA_API_BASE> --transport stdio certta -- npx -y @codespar/mcp-certtaWhat mcp-certta does
The server lists tools for CPF and CNPJ checks, matching a selfie to a document photo, liveness checks, document OCR, and fraud scoring. It also provides signature-envelope operations and onboarding flows that combine KYC, biometrics, and signatures. The README lists 11 tools in total.
It expects a Certta API key in CERTTA_API_KEY; CERTTA_API_BASE can override the base address. However, the configured API host does not resolve in DNS, and none of the tools reaches a live service. A key alone will not make these operations work. The README mentions CAF API hosts too, but this server was not built for them.
What it helps with
- run a KYC or KYB lookup for a CPF or CNPJ
- compare a selfie with a document photo
- extract fields from an identity document using OCR
- request an antifraud score
- create a signature envelope or onboarding flow
Example prompts for the agent
- Check this customer's CPF through Certta and return the KYC result.
- Compare the selfie with the document photo and run a liveness check.
- Start an onboarding flow that combines KYC, biometrics, and a signature.
How to install mcp-certta
Platform CLI
claude mcp add --env CERTTA_API_KEY=<CERTTA_API_KEY> --env CERTTA_API_BASE=<CERTTA_API_BASE> --transport stdio certta -- npx -y @codespar/mcp-certtaReplace <…> with your own values
Platform CLI
codex mcp add certta --env CERTTA_API_KEY=<CERTTA_API_KEY> --env CERTTA_API_BASE=<CERTTA_API_BASE> -- npx -y @codespar/mcp-certtaReplace <…> with your own values
Config file
{
"mcpServers": {
"certta": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-certta"
],
"env": {
"CERTTA_API_KEY": "<CERTTA_API_KEY>",
"CERTTA_API_BASE": "<CERTTA_API_BASE>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"certta": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-certta"
],
"env": {
"CERTTA_API_KEY": "<CERTTA_API_KEY>",
"CERTTA_API_BASE": "<CERTTA_API_BASE>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e CERTTA_API_KEY=<CERTTA_API_KEY> -e CERTTA_API_BASE=<CERTTA_API_BASE> certta npx -y @codespar/mcp-certtaReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-certta
How do I install mcp-certta in Claude Code?
For setup with an API key, run claude mcp add mcp-certta -e CERTTA_API_KEY=<CERTTA_API_KEY> -- npx -y @codespar/mcp-certta. The server currently cannot reach a live API service.
What does mcp-certta do?
It gives an agent tools for identity checks, biometrics, document OCR, fraud scoring, signatures, and onboarding flows. Those tools currently cannot connect to a working service.
What credentials and API address does mcp-certta use?
It requires CERTTA_API_KEY, and CERTTA_API_BASE can set the API base address. The server was not built for the CAF endpoints mentioned in its README.