Mcp Brasil Api

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

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

已验证STDIO仅桌面位置与生活金融商业与电商

概览

AI 生成的概览

本地 MCP 服务器，接入 BrasilAPI，可查询巴西邮编、企业、银行、FIPE 车价、节假日、天气等公开数据。

可以做什么
  • 按 CEP 查询巴西地址，按 CNPJ 查询企业信息
  • 列出巴西银行、Pix 参与机构以及 CVM 注册的券商
  • 查询 FIPE 参考表、车辆品牌、车型与价格
  • 获取节假日、IBGE 州与市镇、DDD 区号、NCM 税则编码、ISBN 图书信息和 .br 域名注册信息
  • 获取 CPTEC/INPE 的天气预报、首府与机场天气以及海洋预报
  • 读取 Selic、CDI、IPCA 等巴西当前经济利率
适用场景
当助手需要巴西公开参考数据时适用，例如核对地址或企业信息、查询车价、节假日、税率或当地天气，无需自行编写 API 调用。
运行要求
以 stdio 方式在本地运行，通常通过 npx 启动 npm 包 @codespar/mcp-brasil-api，因此需要 Node.js 以及访问 BrasilAPI 的网络连接。无需认证、API 密钥或环境变量。
安装前请注意
所有工具都是对免费公开 API 的只读查询；查询内容（如 CEP、CNPJ 或域名）会发送到 BrasilAPI 的第三方服务器。README 还提到独立的付费企业版服务，不属于本服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Brasil Api，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-brasil-api

MCP server for BrasilAPI — free public data APIs for CEP, CNPJ, banks, holidays, FIPE, and more

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "brasil-api": {      "command": "npx",      "args": ["-y", "@codespar/mcp-brasil-api"]    }  }}

Claude Code

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

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "brasil-api": {      "command": "npx",      "args": ["-y", "@codespar/mcp-brasil-api"]    }  }}

Tools (24)

ToolPurpose
get_cepLook up address by CEP (Brazilian postal code)
get_cnpjLook up company information by CNPJ
get_banksList all Brazilian banks with codes and names
get_holidaysList national holidays for a given year
get_fipe_brandsList vehicle brands by type from FIPE table
get_fipe_priceGet vehicle price from FIPE table by code
get_dddGet state and cities for a DDD (area code)
get_isbnLook up book information by ISBN
get_ncmLook up NCM tax classification code
get_cptec_weatherGet weather forecast for a city (CPTEC/INPE)
get_pix_participantsList Pix participant institutions (PSPs/banks enrolled in Pix)
get_domain_infoLook up .br domain registration info
get_ibge_municipalitiesList all municipalities for a Brazilian state (IBGE data)
get_tax_ratesGet current Brazilian tax/economic rates (Selic, CDI, IPCA)
get_cptec_citiesSearch CPTEC/INPE cities by name for weather forecasts
get_cep_v1Look up address by CEP using BrasilAPI v1 (single-provider, often faster than v2)
get_fipe_vehiclesList vehicle models for a given FIPE brand code and vehicle type
get_fipe_tablesList FIPE reference tables (months/years available for FIPE queries)
get_cptec_airport_weatherGet current airport weather (METAR) by ICAO code from CPTEC/INPE
get_cptec_capitals_weatherGet current weather conditions for all Brazilian state capitals
get_cptec_ocean_forecastGet ocean/wave forecast for a coastal city (CPTEC/INPE)
get_ibge_statesList all Brazilian states/UFs with IBGE codes and metadata
get_corretorasList all CVM-registered Brazilian brokerages (corretoras)
get_corretoraLook up a single CVM-registered brokerage by CNPJ

Authentication

No authentication required. BrasilAPI is a free public API.

Sandbox / Testing

No sandbox needed. BrasilAPI is free and open for all requests.

Get your credentials

No credentials needed. Just install and use.

Environment Variables

No environment variables required.

Roadmap

v0.2 (planned)

  • get_pix_participants — Get list of Pix participant institutions
  • get_domain_info — Get domain registration info
  • get_vehicle_info — Get vehicle info by license plate (FIPE)
  • get_ibge_municipalities — List municipalities by state (IBGE)
  • get_tax_rates — Get current tax rates (Selic, CDI, IPCA)

v0.3 (planned)

  • get_cvm_funds — Get investment fund data from CVM
  • get_election_results — Get election results by region

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

来源：packages/identity/brasil-api/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分