mcp-bigdatacorp — Claude Code MCP server: Brazilian KYC data
Wires BigDataCorp into your agent: CPF and CNPJ lookups, vehicles, property, antifraud scoring. Useful when you build onboarding or credit flows for Brazil.
claude mcp add --env BIGDATACORP_ACCESS_TOKEN=<BIGDATACORP_ACCESS_TOKEN> --env BIGDATACORP_TOKEN_ID=<BIGDATACORP_TOKEN_ID> --env BIGDATACORP_API_BASE=<BIGDATACORP_API_BASE> --transport stdio bigdatacorp -- npx -y @codespar/mcp-bigdatacorpWhat mcp-bigdatacorp does
Ten tools ship with the server. Four handle plain lookups: a person from a CPF, a company from a CNPJ, a vehicle from plate, chassis or RENAVAM, a property from an address or registration. The other six cover narrower slices — income, score and default history, employment details, screening against OFAC, UN, EU, Brazilian PEP, CNJ, INSS and IBAMA lists, social presence, a composite fraud score between 0 and 1000 with a decision recommendation, and address normalisation through CORREIOS and IBGE with geocoding.
Auth is paired. There is no Bearer token here: every call carries an AccessToken header and a TokenId header, both issued from the BigDataCorp dashboard. Miss either one and the request fails. BIGDATACORP_ACCESS_TOKEN and BIGDATACORP_TOKEN_ID are mandatory; BIGDATACORP_API_BASE only matters if you point traffic somewhere other than https://plataforma.bigdatacorp.com.br.
Two other Brazilian identity providers sit in the same catalog. Certta pairs KYC with biometrics and ICP-Brasil signatures, which suits onboarding that ends in a signed contract. Caf orchestrates policy rules inside hosted flows. Pick BigDataCorp when one call should return both a wide data set and a fraud score.
The server runs over stdio through npx, so Node has to be available on the machine.
What it helps with
- verify an individual by CPF before approving a loan
- pull company registration details from a CNPJ
- trace a vehicle by plate or RENAVAM
- screen a customer against sanctions and PEP lists
- get a fraud score and decision hint for an application
Example prompts for the agent
- Look up CPF 123.456.789-00 with
persons_lookupand list the addresses and contacts - Run
antifraud_scoreon this application and explain the recommendation - Check this counterparty with
sanctions_checkandcompanies_lookupon the CNPJ
How to install mcp-bigdatacorp
Platform CLI
claude mcp add --env BIGDATACORP_ACCESS_TOKEN=<BIGDATACORP_ACCESS_TOKEN> --env BIGDATACORP_TOKEN_ID=<BIGDATACORP_TOKEN_ID> --env BIGDATACORP_API_BASE=<BIGDATACORP_API_BASE> --transport stdio bigdatacorp -- npx -y @codespar/mcp-bigdatacorpReplace <…> with your own values
Platform CLI
codex mcp add bigdatacorp --env BIGDATACORP_ACCESS_TOKEN=<BIGDATACORP_ACCESS_TOKEN> --env BIGDATACORP_TOKEN_ID=<BIGDATACORP_TOKEN_ID> --env BIGDATACORP_API_BASE=<BIGDATACORP_API_BASE> -- npx -y @codespar/mcp-bigdatacorpReplace <…> with your own values
Config file
{
"mcpServers": {
"bigdatacorp": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-bigdatacorp"
],
"env": {
"BIGDATACORP_ACCESS_TOKEN": "<BIGDATACORP_ACCESS_TOKEN>",
"BIGDATACORP_TOKEN_ID": "<BIGDATACORP_TOKEN_ID>",
"BIGDATACORP_API_BASE": "<BIGDATACORP_API_BASE>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"bigdatacorp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-bigdatacorp"
],
"env": {
"BIGDATACORP_ACCESS_TOKEN": "<BIGDATACORP_ACCESS_TOKEN>",
"BIGDATACORP_TOKEN_ID": "<BIGDATACORP_TOKEN_ID>",
"BIGDATACORP_API_BASE": "<BIGDATACORP_API_BASE>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e BIGDATACORP_ACCESS_TOKEN=<BIGDATACORP_ACCESS_TOKEN> -e BIGDATACORP_TOKEN_ID=<BIGDATACORP_TOKEN_ID> -e BIGDATACORP_API_BASE=<BIGDATACORP_API_BASE> bigdatacorp npx -y @codespar/mcp-bigdatacorpReplace <…> 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-bigdatacorp
How do I install mcp-bigdatacorp in Claude Code?
Run `claude mcp add mcp-bigdatacorp -e BIGDATACORP_ACCESS_TOKEN=<BIGDATACORP_ACCESS_TOKEN> -e BIGDATACORP_TOKEN_ID=<BIGDATACORP_TOKEN_ID> -- npx -y @codespar/mcp-bigdatacorp. A second form adds --env BIGDATACORP_API_BASE=<BIGDATACORP_API_BASE> and --transport stdio` when you need a custom API base.
What does mcp-bigdatacorp do?
It exposes BigDataCorp data to the agent: people, companies, vehicles, property, income, employment, sanctions, social signals, antifraud and addresses. Each of the ten tools maps to one endpoint.
How is BigDataCorp different from Certta and Caf?
BigDataCorp leans on data enrichment and antifraud, aimed at KYC, AML and credit decisions. Certta adds biometrics and ICP-Brasil signing, while Caf orchestrates policy rules for hosted onboarding.
