BrasilAPI MCP. Audit CEP, CNPJ, and banking data instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
BrasilAPI. Access core Brazilian institutional data—CEP, CNPJ, banking, and state info—directly through your AI agent. It lets you audit company profiles, geolocate addresses, and check market data without visiting government websites.
It's the single gateway for reliable, structured Brazilian public records lookup.
What your AI agents can do
Get brazilian holidays
Retrieves a list of national holidays across Brazil for a specific year.
Get cep details
Gets high-resolution address details for any given Brazilian postal code (CEP).
Get cnpj details
Retrieves detailed registration metadata for a Brazilian corporate tax ID (CNPJ).
You pass a CEP, and the agent returns specific address details, including the neighborhood and city.
The agent takes a CNPJ and returns detailed registration data, covering the company's tax status and primary economic activity.
You request a list of banks, and the agent provides the official operating codes and clearing metadata for each institution.
The agent accepts a vehicle identifier and returns its current market valuation from the FIPE table.
The agent lists all Brazilian states (UFs) using IBGE metadata.
You specify a year, and the agent returns a list of official Brazilian national holidays for that date range.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
BrasilAPI: 6 Tools for Brazilian Data Lookup
These six tools let your agent pull structured data on addresses, companies, banks, and more from official Brazilian public records.
019d8420get brazilian holidays
Retrieves a list of national holidays across Brazil for a specific year.
019d8420get cep details
Gets high-resolution address details for any given Brazilian postal code (CEP).
019d8420get cnpj details
Retrieves detailed registration metadata for a Brazilian corporate tax ID (CNPJ).
019d8420get fipe vehicle price
Gets the current market price for a vehicle from the FIPE table.
019d8420list brazilian banks
Lists every bank operating in Brazil and provides their official codes.
019d8420list brazilian states
Lists all official states (UFs) in Brazil according to IBGE data.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with BrasilAPI, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're getting your AI agent access to core Brazilian institutional data. This lets you audit companies, check addresses, and look up market stats without having to hit up government websites. You've got the single gateway for reliable Brazilian public records. You can validate addresses by giving the agent a CEP; it'll hand back specific neighborhood and city details.
You can audit a company's legal status by feeding it a CNPJ; the agent returns detailed registration data, covering the company's tax status and main economic activity. You'll get a list of every bank operating in Brazil, along with their official codes and clearing info. You can check a vehicle's current market price using the FIPE table by providing an identifier.
You can list all Brazilian states (UFs) using IBGE data. If you need to check national holidays, just give the agent a year, and it'll pull the official list of Brazilian holidays for you. You'll also get a list of every bank operating in Brazil and their official codes using the list_brazilian_banks tool.
How BrasilAPI MCP Works
- 1 Connect BrasilAPI to your agent client (Claude, Cursor, etc.).
- 2 Ask your agent a question requiring Brazilian data (e.g., 'What is the CNPJ for X?').
- 3 The agent calls the correct tool, processes the data, and gives you the final answer in plain language.
The bottom line is, you never leave your chat window. Your agent handles the complex data lookups and formats the output for you.
Who Is BrasilAPI MCP For?
The sales ops engineer who needs to verify lead addresses and company metadata in real time. Or the financial analyst who needs rapid banking code audits. This tool is for anyone building systems that must interact with formal Brazilian legal or geographic data.
Verifies lead addresses using get_cep_details and pulls corporate metadata using get_cnpj_details right within the sales workflow.
Checks delivery areas using get_cep_details and verifies national holiday constraints using get_brazilian_holidays before scheduling shipments.
Performs rapid audits of banking codes using list_brazilian_banks and checks vehicle valuations using get_fipe_vehicle_price for asset reports.
What Changes When You Connect
- Checks addresses instantly. Instead of manually checking a mailing service, use
get_cep_detailsto get high-resolution neighborhood and city data for any Brazilian ZIP code. - Validates corporate data in seconds.
get_cnpj_detailsretrieves full company records, including tax status and economic activity, directly for your workflow. - Streamlines logistics planning. You can use
get_brazilian_holidaysto check national closures andlist_brazilian_statesto manage regional operations without leaving your agent. - Provides financial intelligence. Get banking codes and metadata using
list_brazilian_banksor check current asset values withget_fipe_vehicle_price. - Reduces manual effort. You don't have to jump between government portals. Your agent handles the complex lookups for Brazilian data points, keeping everything in one conversation.
- Ensures accuracy. The tools provide structured, verified data from official sources, minimizing the risk of using outdated or unverified public records.
Real-World Use Cases
Onboarding a New Client in Brazil
A sales rep needs to verify a lead's address and company status. The rep asks the agent to 'check out the client at [CEP] with CNPJ [CNPJ]'. The agent calls get_cep_details and get_cnpj_details sequentially, giving the rep a full, verified profile instantly.
Planning a Multi-State Delivery Route
A logistics manager needs to schedule a shipment across three states. They ask the agent to check the route's viability. The agent uses list_brazilian_states to confirm the states are active, then checks get_brazilian_holidays for any national shutdowns, ensuring the shipment date is valid.
Auditing a Corporate Target for Investment
A financial analyst needs to know everything about a company. They ask the agent to 'run a full corporate audit for CNPJ [CNPJ]'. The agent uses get_cnpj_details and then follows up by using list_brazilian_banks to check the industry's primary banking partners.
Inventory Valuation for a Sale
A user selling vehicles needs to quickly know the market price. They prompt the agent with a vehicle ID. The agent runs get_fipe_vehicle_price and delivers the current FIPE valuation, solving the valuation question immediately.
The Tradeoffs
Using general search APIs
Typing 'CEP 01001000 address' into a general search engine and copying the messy result. You get fragmented, hard-to-read data that requires manual cleaning and verification.
→
Use get_cep_details. This tool pulls structured, high-resolution address data directly into your agent's output, eliminating the need for copy-pasting and manual formatting.
Checking data manually on websites
Navigating to multiple government websites to cross-reference a CNPJ, then opening a spreadsheet to compile the data. This takes hours and you risk using outdated information.
→
Let the agent use get_cnpj_details. It pulls the full registration metadata in one call, giving you a verified, single source of truth for the company.
Relying on single-point data checks
Only checking the bank list and missing the official codes, which leads to payment processing failure. You need more context than just a list.
→
Use list_brazilian_banks. It provides the full list of banks plus the necessary official codes and clearing metadata, ensuring your payment logic works right out of the gate.
When It Fits, When It Doesn't
Use this if your workflow requires accessing specific, authoritative Brazilian public records—like CEP validation, CNPJ status checks, or official banking codes. It's essential for compliance, logistics, or financial reporting in Brazil.
Don't use this if you just need general knowledge (e.g., 'What is the capital of Brazil?'). For that, your agent's general knowledge base is fine. Also, don't use it if you need complex, interconnected data models that require merging data from five different external sources; this tool is a set of specialized lookups. If you need a general data pipeline, you'll need a different type of orchestration layer.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by BrasilAPI. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 6 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Gathering basic Brazilian data is a mess of tabs and clicks.
Today, verifying a single Brazilian lead requires jumping through hoops. You start on a lead sheet, copy the CEP, then open a separate site to check the address details. Next, you copy the CNPJ and paste it into a different form to see the company's tax status. You spend time managing which website is right, and you risk using data that hasn't been updated since last week.
With BrasilAPI, you just ask your agent: 'Give me the full profile for this lead.' The agent handles the calls to `get_cep_details` and `get_cnpj_details` automatically. You get a single, structured answer that tells you everything you need, without you ever leaving the chat.
BrasilAPI MCP Server: Audit Brazilian Data with AI
Manually checking national holidays, state codes, and bank listings is a tedious chore. You have to keep track of multiple spreadsheets, manually checking dates against different government calendars to ensure your operations are compliant.
Now, your agent handles that. You simply ask, 'Are there any national holidays in Brazil in Q4?' and the agent calls `get_brazilian_holidays`. It gives you the definitive list, letting you focus on running the business, not chasing compliance data.
Common Questions About BrasilAPI MCP
How do I use get_cnpj_details with BrasilAPI? +
You provide the CNPJ number to your agent. The agent then calls get_cnpj_details and returns the company's full registration metadata, including its tax status and main economic activity.
Can get_cep_details handle international addresses? +
No, get_cep_details is specifically designed for Brazilian postal codes (CEP). It returns high-resolution address data for locations within Brazil.
What does list_brazilian_banks do? +
It lists every bank operating in Brazil. More importantly, it gives you the official codes and clearing metadata required for payment system integration.
Is get_fipe_vehicle_price reliable for selling cars? +
Yes, get_fipe_vehicle_price pulls the current market valuation from the FIPE table, which is the standard reference for vehicle pricing in Brazil.
How do I check for holidays using get_brazilian_holidays? +
You ask your agent for the year you are interested in. The agent uses get_brazilian_holidays and gives you a list of official national holidays for that year.
What information can I get using list_brazilian_states? +
It lists all states (UFs) in Brazil. You get a comprehensive list that includes state names and their corresponding IBGE metadata, which is useful for regional filtering.
Does get_cnpj_details handle incomplete or invalid CNPJ numbers? +
The tool requires a valid CNPJ number to function. If the input is incomplete or invalid, it will return a specific error code indicating the malformed data, preventing bad lookups.
Are there any limitations when calling get_cep_details repeatedly? +
BrasilAPI does not impose strict rate limits, but excessive calls in a short time may slow down your agent's performance. It's best practice to batch your requests where possible.
Is an API Key required for BrasilAPI? +
No. BrasilAPI is a free and open service. This server works out of the box without any static credentials required.
Can the agent validate Brazilian companies? +
Yes. Use the get_cnpj_details tool providing the 14-digit CNPJ. Your agent will retrieve the official registration data, including partners and legal status.
Is the FIPE vehicle table supported? +
Yes. The get_fipe_vehicle_price tool allows your agent to query the latest vehicle valuations in Brazil using standard FIPE codes.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Portfolio CSV Analyzer
Parse massive CSV exports from brokers like DEGIRO or XTB instantly. Streams financial data locally to prevent AI crashes, returning clean column schemas and sample data.
DummyJSON
Access a comprehensive suite of dummy data for testing and prototyping — products, carts, and user authentication directly from your AI agent.
Brawl Stars
Access real-time Brawl Stars data — track player stats, battle logs, club rankings, and event rotations directly from your AI agent.
You might also like
MediaWiki
Connect to any MediaWiki instance to search pages, read content, list categories, and track recent changes directly from your AI agent.
Cloudflare Stream
Manage video infrastructure via Cloudflare Stream—list videos, manage live inputs, and handle uploads directly from any AI agent.
Formstack
Manage professional forms, track submissions, and automate data collection via AI agents with Formstack.