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)
-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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.

  1. Tools
    1. Development
      1. Debugging
    2. Integration with AI applications
      1. Running through Smithery
      2. Usage with Claude
      3. Cursor and other integrations
      4. Running the server with a local copy
    3. Server's capabilities inspection
      1. Project structure

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
          Last updated -
          2
          5,133
          334
          JavaScript
          MIT License
          • Apple
          • Linux
        • A
          security
          F
          license
          A
          quality
          Enables AI assistants to interact with the World Bank open data API, allowing for listing and analysis of indicators across available countries.
          Last updated -
          1
          8
          Python
        • -
          security
          -
          license
          -
          quality
          An MCP server that enables querying detailed address information from Brazilian postal codes (CEPs) via the ViaCEP API, returning data such as street names, neighborhoods, cities, states, regions, and IBGE codes.
          Last updated -
          TypeScript
          MIT License
        • -
          security
          -
          license
          -
          quality
          A Model Context Protocol server that connects AI assistants to Brazilian public data services, providing access to postal codes, company registrations, bank information, area codes, IBGE data, currency exchange rates, and domain registration status.
          Last updated -
          3
          TypeScript
          MIT License

        View all related MCP servers

        ID: x84kncg722