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

Tools (10)

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:

• Platform: https://plataforma.bigdatacorp.com.br

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