BrasilAPI MCP Server
About
A Model Context Protocol (MCP) server that provides tools to query BrasilAPI across different clients and LLMs. Enhance your AI apps with rich data from Brasil resources.
Details
- Author
- mauricio-cantu
- GitHub stars
- 7
- Downloads
- 377
- Categories
- Developer Tools, AI
Jump to
- Query postal codes, area codes, banks, holidays, taxes, and more.
- Unified interface for all BrasilAPI endpoints.
- Seamless integration with AI applications like Claude and Cursor.
- Run via Smithery or locally with Node.js or Docker.
- Full set of MCP tools for every BrasilAPI endpoint.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
BrasilAPI MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
You can run the server automatically through Smithery (npx -y @smithery/cli install @mauricio-cantu/brasil-api-mcp-server) or locally by building the project with npm install && npm run build and then executing node /absolute/path/to/brasil-api-mcp-server/build/index.js. For development, use npm run watch for auto-rebuild. The server exposes tools that correspond to every BrasilAPI endpoint; inspect available tools via Smithery's inspect command or the Smithery tools page.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"brasilapi mcp server": {
"brasil-api-mcp-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@mauricio-cantu/brasil-api-mcp-server"
]
}
}
}
}McpServers
{
"brasil-api-mcp-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@mauricio-cantu/brasil-api-mcp-server"
]
}
}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)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
