# mcp-bigdatacorp

Wires BigDataCorp into your agent: CPF and CNPJ lookups, vehicles, property, antifraud scoring. Useful when you build onboarding or credit flows for Brazil.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/identity/bigdatacorp
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-bigdatacorp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BIGDATACORP_ACCESS_TOKEN`, `BIGDATACORP_TOKEN_ID`, `BIGDATACORP_API_BASE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-bigdatacorp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-bigdatacorp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-bigdatacorp
```
Replace <…> with your own values

## When to use it
- 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
- Look up CPF 123.456.789-00 with `persons_lookup` and list the addresses and contacts
- Run `antifraud_score` on this application and explain the recommendation
- Check this counterparty with `sanctions_check` and `companies_lookup` on the CNPJ

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 40 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md