Brasil API MCP server

by codespar·io.github.codespar/mcp-brasil-api·v0.2.2·271 stars

No reviews yet

MCP server for BrasilAPI — CEP, CNPJ, banks, FIPE, holidays, weather

A91/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A91/100

full report

Adoption

Growing

271 stars

Reviews

Write one

Nobody has reviewed Brasil API yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Brasil API tools (24)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

get_banks
List all Brazilian banks with codes and names
get_cep
Look up address by CEP (Brazilian postal code)
get_cep_v1
Look up address by CEP using BrasilAPI v1 (single-provider, often faster than v2)
get_cnpj
Look up company information by CNPJ
get_corretora
Look up a single CVM-registered brokerage by CNPJ
get_corretoras
List all CVM-registered Brazilian brokerages (corretoras)
get_cptec_airport_weather
Get current airport weather (METAR) by ICAO code from CPTEC/INPE
get_cptec_capitals_weather
Get current weather conditions for all Brazilian state capitals
get_cptec_cities
Search CPTEC/INPE cities by name for weather forecasts
get_cptec_ocean_forecast
Get ocean/wave forecast for a coastal city (CPTEC/INPE)
get_cptec_weather
Get weather forecast for a city (CPTEC/INPE)
get_ddd
Get state and cities for a DDD (area code)
get_domain_info
Look up .br domain registration info
get_fipe_brands
List vehicle brands by type from FIPE table
get_fipe_price
Get vehicle price from FIPE table by code
get_fipe_tables
List FIPE reference tables (months/years available for FIPE queries)
get_fipe_vehicles
List vehicle models for a given FIPE brand code and vehicle type
get_holidays
List national holidays for a given year
get_ibge_municipalities
List all municipalities for a Brazilian state (IBGE data)
get_ibge_states
List all Brazilian states/UFs with IBGE codes and metadata
get_isbn
Look up book information by ISBN
get_ncm
Look up NCM tax classification code
get_pix_participants
List Pix participant institutions (PSPs/banks enrolled in Pix)
get_tax_rates
Get current Brazilian tax/economic rates (Selic, CDI, IPCA)

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings

Code scan5 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 29 days ago15/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 91/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Brasil API compares

Against every graded Maps and travel MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 91/100; higher than 90% of 681 Maps and travel servers
Tools: 24; the typical Maps and travel server has 6
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 271; more than 98% of 324 Maps and travel servers

What its tools let an agent do: 24 read

Install Brasil API in Claude Code, Cursor or VS Code

Runs npx -y @codespar/mcp-brasil-api on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-brasil-api -- npx -y @codespar/mcp-brasil-api

Add to Cursor

What the publisher says

From the Brasil API repository's README, as published. We do not edit it. Read it on GitHub

MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute

The Problem

AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).

Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.

MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.

The Solution

Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

Six systems. Zero human intervention. One agent.

Agentic Payment Protocols

Four servers for the emerging agentic payment stack:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Brasil API: common questions

Is Brasil API MCP server safe?: Yes, by our scan: it is graded A (91/100). Read the Brasil API safety report
How do I install Brasil API?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Brasil API need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Brasil API maintained?: The last commit was 67 days ago (2026-08-29). The latest release is v0.2.2.
What can I use instead of Brasil API?: Servers from other publishers that do the same job: Openvan Travel MCP server, Japan Data MCP server and Weather Data MCP Server.
How does Brasil API compare with other Maps and travel MCP servers?: safety score 91/100 (higher than 90% of 681 Maps and travel servers); tools 24 (the typical Maps and travel server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Brasil API

Same job from other publishers: the closest match first, then the best rated.

Openvan Travel
Vanlife & RV data: roadbooks, fuel, tolls, ferries, visas, holidays, hazards, weather. openvan.camp
not reviewed
Growing
A
Japan Data MCP
30 tools for Japanese data: address, furigana, transit, Diet, holidays, weather, corporate registry
not reviewed
Growing
B
Weather Data MCP Server
17 weather tools, no API keys: forecasts, alerts, air quality, marine, radar, lightning, wildfires
not reviewed
Established
A
Weather MCP Server
providing weather information, air quality data, and timezone utilities using the Open-Meteo API.
not reviewed
Established
A
Variflight
VariFlight's official MCP server provides tools to query flight, weather, comfort, and fare data.
not reviewed
Growing
A