Log inSubmit server
Brasil Data MCP logo

Brasil Data MCP

by alanpcf

Queries Brazilian public data through 15 MCP tools, including CNPJ, CEP, banks, holidays, exchange rates, IBGE data, and .br domains.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Brasil Data MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "alanpcf-brasil-data-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "brasil-data-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 15 tools correctly (1mo ago).

Overview

alanpcf/brasil-data-mcp MCP server exposes Brazilian public data through MCP tools backed by BrasilAPI, with no authentication or API key required. It covers company registrations, postal codes, banks, national holidays, DDDs, ISBN metadata, economic rates, exchange rates, CVM brokers, IBGE locations, and .br domain status. Install it locally with npx and connect it to an MCP client such as Claude Desktop, Cursor, or Windsurf. Reach for it when an agent needs structured Brazilian reference data rather than general web search or custom HTTP integrations.

Use cases

  • Look up company registration details from a Brazilian CNPJ
  • Resolve a CEP into a Brazilian address
  • Compare current SELIC, CDI, and IPCA values
  • Check PTAX exchange rates for supported currencies
  • Verify the availability of a .br domain

Key features

  • 15 MCP tools for Brazilian public data
  • CNPJ, CEP, bank, DDD, ISBN, and holiday lookups
  • BACEN economic rates and PTAX exchange data
  • IBGE states and municipality codes
  • CVM broker and Registro.br domain queries
  • Two guided MCP prompts

Tools15

What Brasil Data MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · brasil-data-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
npm downloads103Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed15Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Brasil Data MCP works

What alanpcf/brasil-data-mcp MCP server does

alanpcf/brasil-data-mcp MCP server gives compatible AI clients access to Brazilian public data through 15 tools. The tools query BrasilAPI and return structured JSON for common identifiers and reference datasets. Covered sources and domains include Receita Federal company records, CEP address lookup, BACEN bank and economic data, CVM broker records, IBGE states and municipalities, Registro.br domain status, PTAX exchange bulletins, and book metadata from multiple providers.

The project also includes two MCP prompts: analise-cnpj, which guides a structured company analysis, and panorama-economico, which combines current economic rates with upcoming national holidays.

How it works

An MCP client selects a tool based on the user's request, passes an identifier or other supported input, and receives JSON for the agent to interpret. Inputs generally accept Brazilian formats with or without punctuation where applicable, such as masked or unmasked CNPJ, CEP, and ISBN values.

The available operations are deliberately directional. CEP lookup returns an address from a CEP, but does not find a CEP from an address. Bank lookup accepts a COMPE or Febraban code, while name-based searches use the full bank list. Municipality lookup is scoped to one Brazilian state. Similar restrictions apply to DDD, ISBN, broker, and domain queries.

Exchange lookups use PTAX data for one date at a time. When no date is supplied, the service checks the previous day because the source does not expose the current day's quote. A non-trading date returns the most recent prior business-day bulletin.

Setup and configuration

alanpcf/brasil-data-mcp MCP server runs locally through the published npm package. No credentials, API key, or environment variables are required. The direct command is:

Terminal
npx -y brasil-data-mcp

For Claude Desktop or Cursor, configure an MCP server with npx as the command and -y brasil-data-mcp as its arguments.

The server can be used with Claude Desktop, Claude Code, Cursor, Windsurf, and other MCP-compatible clients. The listed client configurations use standard stdio transport.

Tools and capabilities

The tool set includes:

  • Query company registration details by CNPJ, including status, address, CNAE, partners, capital, and contact information.
  • Resolve Brazilian CEPs to state, city, neighborhood, street, and available coordinates.
  • Look up banks by code or list BACEN-registered institutions with COMPE and ISPB values.
  • Retrieve national holidays for a year, including movable dates, and inspect DDD coverage by state and city.
  • Retrieve ISBN-10 or ISBN-13 book metadata from title through available synopsis and source.
  • Read current SELIC, CDI, and IPCA values individually or as a combined list.
  • Inspect CVM broker registration data by CNPJ and query PTAX quotations for supported foreign currencies.
  • List Brazil's 27 federative units or retrieve all municipalities and IBGE codes for one state.
  • Check whether a .br domain is available or registered, including DNS hosts, expiration, and suggestions when provided.

Limitations and notes

The data scope is Brazil-specific. CNPJ lookup is not intended for CPF records or foreign companies; CEP lookup does not support international postal codes; and domain checks cover .br only. Holiday lookup covers national holidays, not state or municipal calendars. Economic tools provide current values rather than historical series and support SELIC, CDI, and IPCA only.

Currency lookup supports the 10 currencies listed by the service and does not cover cryptocurrencies or BRL as a foreign currency. Municipality results can be large; São Paulo, for example, has 645 entries. Domain results are not cached and represent the current status returned by the source. Invalid identifier formats should be rejected locally where the tool guidance requires validation before making a request.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Brasil Data MCP

Run `npx -y brasil-data-mcp`, then add that command and its arguments to the MCP client configuration.

No.

Yes. The README provides a Claude Desktop stdio configuration using `npx -y brasil-data-mcp`.

Yes. The `consultar_dominio_br` tool checks current `.br` registration status and can return hosts, expiration data, and suggestions when available.

Related MCP servers

All in Data Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBrasil Data MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/alanpcf-brasil-data-mcp?style=directory)](https://allmcps.com/mcp/alanpcf-brasil-data-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/alanpcf-brasil-data-mcp"><img src="https://allmcps.com/api/badge/alanpcf-brasil-data-mcp?style=directory" alt="Brasil Data MCP on AllMCPs" /></a>