BrasilAPI MCP Server

Source

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.

Catalog onlyCatalog onlySTDIO

Overview

BrasilAPI MCP Server is a Model Context Protocol (MCP) server designed to provide tools for querying BrasilAPI across various clients and large language models (LLMs). It allows LLMs to access a wide range of data from Brazilian resources, including postal codes, area codes, banks, holidays, taxes, company information, and more.

To use the server, you can either run it locally by downloading the repository and executing the server with Node.js, or you can run it automatically via Smithery. You can also integrate it with AI applications like Claude.

Provides tools to query all endpoints available from BrasilAPI. - Supports integration with various AI applications. - Offers debugging capabilities through MCP Inspector.

Accessing postal code information for location-based services.
Retrieving company data for business applications.
Integrating Brazilian data into AI-driven applications.

Add to your AI client

Use these steps to connect BrasilAPI MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "brasil-api-mcp-server-mauricio-cantu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brasil-api-mcp-server-mauricio-cantu"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "brasil-api-mcp-server-mauricio-cantu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brasil-api-mcp-server-mauricio-cantu"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "brasil-api-mcp-server-mauricio-cantu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brasil-api-mcp-server-mauricio-cantu"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "brasil-api-mcp-server-mauricio-cantu": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brasil-api-mcp-server-mauricio-cantu"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "brasil-api-mcp-server-mauricio-cantu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brasil-api-mcp-server-mauricio-cantu"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "brasil-api-mcp-server-mauricio-cantu": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brasil-api-mcp-server-mauricio-cantu"
      ]
    }
  }
}

FAQ

What data can I access through BrasilAPI MCP Server?

You can access a variety of data including postal codes, area codes, banks, holidays, taxes, and company information.

Is there documentation available for BrasilAPI?

Yes, you can find the complete documentation [here](https://brasilapi.com.br/docs).

How do I install the server?

You can install the server by running `npm install` after cloning the repository.

Research and data