Mcp Brasil Api
Validate Brazilian leads and addresses in-agent via BrasilAPI—CEP, CNPJ, banks, FIPE, holidays, and weather—without scraping or paid data vendors early on.
Overview
io.github.codespar/mcp-brasil-api is an MCP server for the Validate phase that lets agents query BrasilAPI for CEP, CNPJ, banks, FIPE, holidays, and weather over stdio.
What is this MCP server?
- BrasilAPI tools: CEP, CNPJ, banks, FIPE, holidays, and weather
- @codespar/mcp-brasil-api v0.1.2 stdio MCP—no mandatory API key in manifest
- Identity and reference data package from codespar/mcp-dev-brasil
- Useful for onboarding forms, KYC light checks, and locale-aware UX research
- MCP 2025-12-11 server schema for npm registry install
- Server version 0.1.2; package @codespar/mcp-brasil-api
- stdio transport; 0 required secret env vars in published schema
- Six API areas documented: CEP, CNPJ, banks, FIPE, holidays, weather
Community signal: 252 GitHub stars.
What problem does it solve?
Scoping a Brazil product without MCP means agents guess at CNPJ formats and CEP rules instead of hitting authoritative public data.
Who is it for?
Indie builders testing Brazil-market apps who want fast CNPJ/CEP and reference lookups inside Claude Code or Cursor during validation.
Skip if: Production-grade KYC without your own compliance review, or teams with zero Brazil footprint who do not need local reference APIs.
What do I get? / Deliverables
After registering the stdio server, your agent can pull BrasilAPI-backed reference data while you validate scope and sketch integrations.
- Stdio MCP tools for six BrasilAPI domains (CEP, CNPJ, banks, FIPE, holidays, weather)
- Faster validation of Brazilian data requirements in chat
- Reusable reference lookups while scoping product integrations
Recommended MCP Servers
Journey fit
Before you commit to a Brazil-facing build, you need cheap CNPJ and CEP checks to scope compliance, logistics, and data models. Scope subphase is where you prove feasibility with real Brazilian identifiers, postal data, and reference datasets before prototyping.
How it compares
MCP facade over free BrasilAPI endpoints, not a paid data provider or government portal scraper skill.
Common Questions / FAQ
Who is io.github.codespar/mcp-brasil-api for?
Developers and solo founders building for Brazil who want agents to access CEP, CNPJ, and other BrasilAPI datasets through MCP.
When should I use io.github.codespar/mcp-brasil-api?
Use it while validating market scope, designing signup flows, or spiking integrations that need Brazilian postal, company, or reference data.
How do I add io.github.codespar/mcp-brasil-api to my agent?
Install @codespar/mcp-brasil-api via npm, add the stdio server to your MCP configuration, and restart your agent—no API key is listed as required in the server manifest.