@codespar/mcp-bigdatacorp
MCP server for BigDataCorp — the Brazilian data-enrichment + KYC platform. CPF / CNPJ / vehicle / property / antifraud datasets used as the standard rail in BR e-commerce + lending agents for KYC, AML, and fraud scoring.
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"bigdatacorp": {
"command": "npx",
"args": ["@codespar/mcp-bigdatacorp"],
"env": {
"BIGDATACORP_ACCESS_TOKEN": "your-access-token",
"BIGDATACORP_TOKEN_ID": "your-token-id"
}
}
}
}
Cursor / VS Code
Same config in .cursor/mcp.json.
Core lookups
| Tool | BigDataCorp endpoint | Notes |
|---|
persons_lookup | POST /v1/datasets/persons | CPF → name, DOB, mother's name, addresses, contacts, deceased flag |
companies_lookup | POST /v1/datasets/companies | CNPJ → razão social, capital, partners, address, CNAE |
vehicles_lookup | POST /v1/datasets/vehicles | Plate / chassis / RENAVAM → make, model, FIPE, ownership, restrictions |
properties_lookup | POST /v1/datasets/properties | Address or registration → owner history + value estimate |
Enrichment slices
| Tool | BigDataCorp endpoint | Notes |
|---|
financial_data | POST /v1/datasets/persons | Income, score, declared assets, banking, default history |
employment_data | POST /v1/datasets/persons | Current employer, history, monthly income, category |
sanctions_check | POST /v1/datasets/persons | OFAC / UN / EU / BR PEP / CNJ / INSS / IBAMA screening |
social_signals | POST /v1/datasets/persons | Instagram / LinkedIn / Twitter / Facebook presence |
Antifraud + address
| Tool | BigDataCorp endpoint | Notes |
|---|
antifraud_score | POST /v1/datasets/antifraud | Composite fraud score (0-1000) + decision recommendation |
address_validation | POST /v1/datasets/addresses | CORREIOS + IBGE normalization + geocode |
Authentication
BigDataCorp uses paired headers (not Bearer):
AccessToken: <BIGDATACORP_ACCESS_TOKEN>
TokenId: <BIGDATACORP_TOKEN_ID>
Both are required on every request. Issue both credentials from the BigDataCorp platform dashboard:
Environment Variables
| Variable | Required | Description |
|---|
BIGDATACORP_ACCESS_TOKEN | yes | AccessToken header value |
BIGDATACORP_TOKEN_ID | yes | TokenId header value (paired) |
BIGDATACORP_API_BASE | no | Override base URL (default https://plataforma.bigdatacorp.com.br) |
BigDataCorp vs Certta vs Caf
Three BR identity rails in this catalog, each with a different specialty:
| Provider | Strength | Best for |
|---|
| BigDataCorp | Broad data enrichment + antifraud | KYC + AML + credit decisioning |
Certta (@codespar/mcp-certta) | KYC + biometrics + ICP-Brasil signature | Onboarding pipelines with signed contracts |
Caf (@codespar/mcp-caf) | KYC + Trust Platform orchestration | Hosted onboarding flows with policy rules |
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