# BrasilAPI MCP for AI Agents MCP

> BrasilAPI connects your AI agent to a massive library of Brazilian public institutional data. Instantly audit addresses using CEP, verify company profiles via CNPJ, or retrieve official banking codes without visiting any government portal. It gives your workflow real-time access to national logistics and financial records.

## Overview
- **Category:** data-management
- **Price:** Free
- **Tags:** brazil-data, cnpj-lookup, cep-validation, banking-data, public-records, data-retrieval

## Description

Complex research on Brazilian institutions used to mean hours of manual form filling across multiple government sites. With this MCP, you give your agent the power to handle that entire process through natural conversation. Your agent doesn't just look up data; it acts like a real-time analyst, instantly validating everything from residential addresses to corporate tax status.

When you connect BrasilAPI to your AI client via Vinkius, you stop copying and pasting between tabs. Instead, you can ask your agent to check a lead’s address, confirm the company's legal standing using its CNPJ, and even get current vehicle valuations—all in one go. Whether you're doing compliance checks or managing cross-border logistics, your data stays verified and up-to-date. You just talk to it.

## Tools

### list_brazilian_banks
Pulls a complete list of every bank currently operating in Brazil.

### get_cep_details
Retrieves full address details for any specific Brazilian zip code (CEP).

### get_cnpj_details
Fetches comprehensive profile information for a Brazilian company using its CNPJ number.

### get_fipe_vehicle_price
Queries the FIPE table to provide current market pricing data for vehicles in Brazil.

### get_brazilian_holidays
Lists all official national holidays in Brazil for a specified year, helping with planning.

### list_brazilian_states
Provides a comprehensive list of all states (UFs) across Brazil from IBGE records.

## Prompt Examples

**Prompt:** 
```
What is the current estimated price for a 2018 Honda Civic in São Paulo?
```

**Response:** 
```
**FIPE Vehicle Price Report**

*   **Vehicle:** Honda Civic Sedan
*   **Year/Model:** 2018 (Manual Transmission)
*   **State/City:** SP / São Paulo
*   **Estimated Market Value:** R$ 65,450.00

*(Data sourced from FIPE table.)*

This valuation is based on current market averages and accounts for regional adjustments.
```

**Prompt:** 
```
I need to check the operational status of a client in Curitiba.
```

**Response:** 
```
**Company Profile Lookup**

*   **CNPJ:** 19.131.243/0001-97 (Example)
*   **Legal Status:** Active / Regular
*   **Primary Activity:** Software Development & Consulting
*   **Location:** Curitiba, PR
*   **Tax Regime:** Lucro Real

The company is active and operates under the 'Lucro Real' tax regime.
```

**Prompt:** 
```
List all banks I should know about for international transfers.
```

**Response:** 
```
**Brazilian Banking Institutions Catalog (Sample)**

The Brazilian financial sector includes over 300 institutions. Here are a few major examples with their official clearing codes:

| Bank Name | Acronym | Clearing Code |
| :--- | :--- | :--- |
| Banco do Brasil | BB | 001 |
| Itaú Unibanco | IUB | 030 |
| Bradesco | BBD | 023 |

I can provide the specific codes for any bank you need.
```

## Capabilities

### Validate any Brazilian address
You can provide a zip code (CEP) and retrieve high-resolution details, including the neighborhood and city.

### Audit company legal status
Input a CNPJ number to get detailed registration data, like tax standing and what industry the company operates in.

### List Brazilian banks and codes
The agent can list all operating banks and provide their official clearing metadata and codes for transactions.

### Check vehicle market price
Get current estimated prices for vehicles using the standard FIPE table data.

### Determine national holidays
List all national holidays in Brazil for any given year, which is crucial for planning logistics timelines.

### Identify Brazilian states and regions
Retrieve a list of all states (UFs) across Brazil using IBGE data to scope regional operations.

## Use Cases

### Onboarding a new Brazilian client
A sales rep asks the agent for compliance checks. The agent uses `get_cnpj_details` to verify the company's legal structure, then uses `list_brazilian_states` to confirm they operate in the correct region. It gives the rep all the necessary background info immediately.

### Optimizing cross-regional shipping routes
A logistics coordinator needs to plan a multi-city delivery schedule. They ask the agent to check `get_brazilian_holidays` for the entire month, preventing them from scheduling trips around public closures.

### Due diligence on an investment target
A financial analyst needs quick data points. They prompt the agent with a CNPJ and ask for market data. The agent uses `get_cnpj_details` combined with `get_fipe_vehicle_price` to give a holistic view of assets.

### Validating a lead's physical location
A sales team member gets a new prospect address. They ask the agent to validate it using `get_cep_details`. The agent returns high-resolution coordinates and neighborhood data, confirming the lead is real.

## Benefits

- Stop manual lookups. Getting corporate status via the `get_cnpj_details` tool means your agent retrieves tax standing and activity data instantly, keeping your workflow moving.
- Planning logistics is simpler. By using `get_brazilian_holidays`, you eliminate the risk of scheduling deliveries when a national holiday shuts down operations.
- Financial vetting is faster. Need to know bank codes? The `list_brazilian_banks` tool gives your agent access to official clearing metadata, saving hours of research.
- Address verification never failed before. Running `get_cep_details` ensures every lead address is geographically accurate and fully resolved right in the chat window.
- Market analysis gets deeper. Use `get_fipe_vehicle_price` to understand current vehicle valuations directly from your agent, making asset monitoring seamless.

## How It Works

The bottom line is that you talk to your AI client like you're talking to a human analyst, and it performs complex government lookups instantly.

1. Subscribe to this MCP on Vinkius. No API key is needed, as BrasilAPI uses a free and open service.
2. Connect the MCP to your preferred AI client (like Claude or Cursor).
3. Ask your agent a natural language question—for example, 'What is the tax status for CNPJ 19131243000197?'—and get the verified data back.

## Frequently Asked Questions

**How does BrasilAPI help me verify a company's legal status in Brazil?**
It provides instant, reliable corporate records using the CNPJ number. You get access to current tax status and detailed information about their primary economic activity without leaving your chat client.

**Can I use BrasilAPI to confirm an address for a new lead?**
Yes, you can run `get_cep_details` on any zip code. It doesn't just give the city; it provides high-resolution neighborhood data and geographic coordinates, making verification much more precise.

**What if I need to plan logistics around national holidays in Brazil?**
You simply ask your agent to list Brazilian national holidays. It checks against the official calendar for a specific year, ensuring you don't schedule critical deliveries or meetings on a public closure date.

**Is BrasilAPI suitable for financial audit work?**
Absolutely. It lets you quickly access and compare data points like official bank clearing codes and current vehicle valuations using the FIPE table, making due diligence much faster.

**Does connecting this MCP require special API keys or complex setup?**
No. You subscribe to the MCP on Vinkius and connect it directly to your AI client. It's a natural language conversation; no technical configuration is needed from you.