# BrasilAPI MCP for AI Agents AI Agent Connect > BrasilAPI gives your AI agent direct access to Brazilian public records, including address data, company registrations, banking info, and vehicle prices. It replaces manual searches through government portals with instant, conversational data retrieval for KYC, logistics, and market research. ## Overview - **Category:** data-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_yViCwTmTtGFH8sKMRDyWhBu0UK7XjUl3SLPbouGZ/ai-agent-connect - **Tags:** brazil-data, cnpj-lookup, cep-validation, banking-data, public-records, data-retrieval ## Description BrasilAPI gives you direct access to Brazilian public records. You don't have to spend time hunting through government websites to find company registrations, zip code details, or banking info. Instead, you just ask your agent to do the work. It handles the heavy lifting of navigating Brazilian institutional data so you can focus on the actual research. You can find out which banks are active in the country or see what the current market value is for a specific vehicle using official tables. It's about moving from how do I find this to tell me about this. Because Vinkius hosts this Connector, you can plug it into your existing workflow and let your agent act as a real-time analyst for anything involving Brazilian public records. If you're working in logistics, you can check for national holidays or verify delivery regions without opening extra tabs. For sales, you can get verified corporate metadata for leads instantly. For finance, you can audit banking codes or check vehicle prices for market reports. It turns a manual research process into a simple conversation, removing the need to navigate confusing portals or deal with inconsistent data formats. You get clean, useful information every time you ask. This means you can verify a lead's location, check a company's tax status, or get a list of regional holidays in one go. It's the fastest way to get accurate Brazilian data without the headache of manual searching. ## Tools ### list_brazilian_banks Get a full list of banks operating in Brazil. This helps you understand the national banking landscape and find official codes. ### get_cnpj_details Retrieve registration metadata for Brazilian companies. You'll get tax status and economic activity info instantly. ### get_fipe_vehicle_price Check the current market price for vehicles using the FIPE table. It's perfect for understanding Brazilian automotive valuations. ### get_brazilian_holidays List all national holidays for a specific year. Use this to coordinate regional operations and avoid scheduling conflicts. ### get_cep_details Pull specific address details for any Brazilian zip code. It's the fastest way to geolocate a customer or business. ### list_brazilian_states Get a list of all Brazilian states and their metadata from IBGE. This helps with regional data mapping and logistics. ## Prompt Examples **Prompt:** ``` Can you check the address for CEP 01001000? ``` **Response:** ``` I've found the address for that zip code. **Location Details:** * **Street:** Praça da Sé * **City:** São Paulo * **State:** SP It's a central location in the city. Would you like the geographic coordinates as well? ``` **Prompt:** ``` What's the status of CNPJ 19131243000197? ``` **Response:** ``` I've identified that company for you: * **Name:** VINKIUS * **Location:** São Paulo * **Main Activity:** Software Development I can also pull the specific tax status or partner details if you need them. ``` **Prompt:** ``` List the banks in Brazil. ``` **Response:** ``` I've pulled the list of banks operating in Brazil. There are over 300 institutions listed. **Sample of major institutions:** | Bank | Official Code | | :--- | :--- | | Banco do Brasil | 001 | | Itaú Unibanco | 341 | | Bradesco | 237 | Would you like the full list or a specific bank's details? ``` ## Capabilities ### Get address details from a CEP Pull specific address details for any Brazilian zip code. ### Pull company registration data via CNPJ Retrieve registration metadata for Brazilian companies. ### List all active banks in Brazil Get a full list of banks operating in Brazil. ### Check current vehicle prices from FIPE Check the current market price for vehicles using the FIPE table. ### Retrieve national holiday dates List all national holidays for a specific year. ### Get state metadata from IBGE Get a list of all Brazilian states and their metadata from IBGE. ## Use Cases ### Verifying a lead's business status A sales rep asks the agent to check if a company is active. The agent uses get_cnpj_details to pull the tax status and activity info. ### Planning a delivery route A logistics manager asks for holidays in a specific state. The agent uses get_brazilian_holidays to provide the correct dates. ### Market research for a car dealership An analyst asks for the average price of a specific vehicle model. The agent uses get_fipe_vehicle_price to get current market data. ### Mapping out a national expansion An operations lead asks for a list of all states and their metadata. The agent uses list_brazilian_states to get the IBGE data. ## Benefits - Stop manual searching: Use get_cep_details to find addresses without opening a browser. - Faster KYC: Use get_cnpj_details to audit companies in seconds instead of minutes. - Accurate logistics: Use get_brazilian_holidays to plan deliveries around national breaks. - Real-time pricing: Use get_fipe_vehicle_price to get current vehicle values for reports. - Better data mapping: Use list_brazilian_states to get accurate regional info from IBGE. - Unified banking info: Use list_brazilian_banks to see the full scope of the Brazilian financial sector. ## How It Works The bottom line is you get instant access to Brazilian public records through a simple conversation. 1. Subscribe to the BrasilAPI MCP in your catalog 2. Connect it to your AI client without needing an API key 3. Ask your agent to find Brazilian company data or address details ## Frequently Asked Questions **How can I use BrasilAPI to find Brazilian company info?** You can ask your agent to look up a specific CNPJ number. It will return the company's registration metadata, tax status, and main economic activity instantly. **Can BrasilAPI help with Brazilian zip code lookups?** Yes, it can pull full address details for any Brazilian CEP. This helps you quickly geolocate customers or businesses without manual searching. **Is there a way to get Brazilian holiday dates automatically?** You can ask your agent to list the national holidays for a specific year. This is great for logistics teams who need to plan around regional breaks. **How do I get vehicle prices in Brazil using BrasilAPI?** Your agent can query the FIPE table to give you current market prices for vehicles. It's perfect for quick market research and valuation reports. **Can BrasilAPI help with KYC for Brazilian businesses?** It makes KYC much faster by pulling verified corporate metadata and tax status for any Brazilian company using their CNPJ. **Does BrasilAPI require an API key to connect?** No, it doesn't. Because it's a free and open service, you can connect it to your AI client through Vinkius without managing any keys. **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.