BrasilAPI MCP Server

This server provides a unified interface to query data from BrasilAPI resources, including postal codes, area codes, banks, holidays, and taxes. It enhances AI agents and applications with updated data from BrasilAPI.

Check the complete and official documentation from BrasilAPI here.

Tools

The server offers tools for every BrasilAPI endpoint, utilizing the brasilapi-js client (https://github.com/WillianAgostini/brasilapi-js). Inspect and test these tools on the Tools page in Smithery.

Development

Install dependencies with npm install, build with npm run build, and use npm run watch for auto-rebuild during development. Debug using the MCP Inspector via npm run inspector or npm run build-and-inspect.

Integration with AI applications

Run the server via Smithery using npx -y @smithery/cli install @mauricio-cantu/brasil-api-mcp-server. For Claude, use npx -y @smithery/cli@latest install @mauricio-cantu/brasil-api-mcp-server --client claude. Other integrations, like Cursor, are available on the Smithery Server page. Run locally with node /absolute/path/to/brasil-api-mcp-server/build/index.js or use the provided Dockerfile.

Server's capabilities inspection

Inspect the server's capabilities with npx -y @smithery/cli@latest inspect @mauricio-cantu/brasil-api-mcp-server.

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)