BrasilAPI MCP Server: Brazil-Specific Data & AI Empowerment

Empower your AI apps with Brazil-specific data! The BrasilAPI MCP Server connects seamlessly across clients and LLMs, delivering rich, localized insights to elevate your projects." )

Visit Repository

✨ Research And Data

4.8(107 reviews)

160 saves

74 comments

Ranked in the top 10% of all AI tools in its category

About BrasilAPI MCP Server

What is BrasilAPI MCP Server: Brazil-Specific Data & AI Empowerment?

BrasilAPI MCP Server is a dedicated interface for accessing Brazil-centric data through a unified API gateway. It provides seamless access to essential information like postal codes, area codes, bank details, tax regulations, and public holidays. By integrating this server into AI applications, developers can enhance decision-making and automation with real-time, localized data from the official BrasilAPI repository. The server acts as a bridge between Brazil’s public datasets and AI tools like Claude, Cursor, and Smithery.

How to Use BrasilAPI MCP Server: Brazil-Specific Data & AI Empowerment?

Getting started is straightforward:

Install via Smithery:
Use the CLI to set up the server automatically:
npx -y @smithery/cli install @mauricio-cantu/brasil-api-mcp-server
Run locally:
Clone the repo, build with npm, and execute:
npm run build && node index.js
Integrate with AI platforms:
Connect to tools like Claude using the server’s API endpoints or leverage Smithery’s workflow orchestration for automation.

BrasilAPI MCP Server Features

Key Features of BrasilAPI MCP Server

Unified Access: Fetch multiple data types (e.g., CEP validation, bank branch codes) via a single API.
Real-Time Updates: Data is synced with official Brazilian government and financial sources.
AI-Ready: Pre-configured integrations for popular platforms like Smithery and Claude.
Debugging Support: Use the MCP Inspector tool for troubleshooting API calls and performance bottlenecks.

Use Cases for BrasilAPI MCP Server

Common scenarios include:

E-commerce: Validate customer addresses using postal code APIs to reduce delivery errors.
Financial Apps: Automate tax compliance checks by pulling real-time tax codes and regulations.
Travel Platforms: Update users on public holidays affecting bookings or services.
Banking Systems: Verify account details and branch locations for fraud prevention.

BrasilAPI MCP Server FAQ

FAQ: BrasilAPI MCP Server

Q: Do I need an API key?
A: No. Data access is open-source and free, but rate limits apply for non-commercial use.

Q: How do I debug my integration?
A: Use the MCP Inspector tool to trace API requests and errors.

Q: Does it support Docker?
A: Yes. A pre-built Dockerfile is included for easy deployment.

Content

BrasilAPI MCP Server

Query a variety of data from Brasil resources seamlessly. Access information on postal codes, area codes, banks, holidays, taxes, and more through a unified interface. Enhance your AI agents and applications with rich and updated data from BrasilAPI effortlessly.

Check the complete and official documentation from BrasilAPI here.

Tools

This server provides tools to query every endpoint available from BrasilAPI. Under the hood, it uses this JS client to communicate with the API: https://github.com/WillianAgostini/brasilapi-js

Check the Tools page in Smithery to inspect and test each one of them.

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

To generate an updated build and inspect:

npm run build-and-inspect

The Inspector will provide a URL to access debugging tools in your browser.

Integration with AI applications

Running through Smithery

Run the server automatically via Smithery:

npx -y @smithery/cli install @mauricio-cantu/brasil-api-mcp-server

Usage with Claude

npx -y @smithery/cli@latest install @mauricio-cantu/brasil-api-mcp-server --client claude

Cursor and other integrations

Check the Server page in Smithery to get other integration options such as Cursor and more.

Running the server with a local copy

After you've downloaded this project, you can run the server using node:

node /absolute/path/to/brasil-api-mcp-server/build/index.js

At the root of the project there's also a Dockerfile to build and run the image if you'd like.

Server's capabilities inspection

You can inspect this MCP server's capabilities using Smithery:

npx -y @smithery/cli@latest inspect @mauricio-cantu/brasil-api-mcp-server

This will show you all available tools, their parameters, and how to use them.

Project structure

src/
  ├── apiClient/   # BrasilAPI client
  ├── tools/       # Tools implementations
  ├── types/       # Interfaces and types
  ├── utils/       # Utility functions
  └── index.ts     # MCP main file (server setup and tools listing)