mauricio_cantu_brasil_api_mcp_server
by mauricio-cantuBrasilAPI MCP Server
Overview
The BrasilAPI MCP Server is a Model Context Protocol (MCP) server that provides tools to query BrasilAPI across different clients and LLMs. It allows you to access a variety of data from Brasil resources, including postal codes, area codes, banks, holidays, taxes, and more. This server enhances your AI applications with rich and updated data from BrasilAPI.
Tools
This server provides tools to query every endpoint available from BrasilAPI. Under the hood, it uses the BrasilAPI JS client to communicate with the API.
You can inspect and test each tool on the Tools page in Smithery.
Configuration
Development
-
Install dependencies:
shell npm install -
Build the server:
shell npm run build -
For development with auto-rebuild:
shell 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.
Usage
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 for other integration options such as Cursor and more.
Running the Server with a Local Copy
After downloading this project, you can run the server using node:
node /absolute/path/to/brasil-api-mcp-server/build/index.js
Alternatively, you can build and run the Docker image provided in the project.
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)
About
The BrasilAPI MCP Server is designed to enhance AI applications with rich data from Brasil resources. It provides a unified interface to query BrasilAPI across different clients and LLMs.
smithery.ai/server/@mauricio-cantu/brasil-api-mcp-server
Topics
Resources
Stars
Watchers
Forks
No releases published
No packages published
![@smithery-ai[bot]](https://accelerate.clipnews.com/images/eJzLKCkpKLbS108sSyxJLCrWS88syShNKi1OLUrOzytJzSvRS87P1c_M0zc0NDC1NDWwL7Y1M1ErszUBAGlwE5Y=.jpg)
Invite Gmail Contacts
