io.github.codespar/mcp-bigdatacorp
io.github.codespar/mcp-bigdatacorp · 273 stars · TypeScript · MIT
MCP server MCP server for BigDataCorp — Brazilian data enrichment + KYC (CPF/CNPJ/vehicle/property/antifraud)
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@codespar/mcp-bigdatacorpstdio
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
BIGDATACORP_ACCESS_TOKENRequired · Secret | Env var | AccessToken header value from the BigDataCorp dashboard |
BIGDATACORP_TOKEN_IDRequired · Secret | Env var | TokenId header paired with the access token |
BIGDATACORP_API_BASEOptional | Env var | API base URL — defaults to BigDataCorp production. Override for sandbox. |
Files
@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
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 273
- License
- MIT
- Language
- TypeScript
- Last push
- 2026-09-27
- Forks
- 50
- MCP Registry
- io.github.codespar/mcp-bigdatacorp
- Homepage
- codespar.dev/servers
- Topics
- agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k