/ 디렉터리 / 플레이그라운드 / mcp-brasil
← 모든 서버 ↗ GitHub
● 커뮤니티 jxnxts ⚡ 바로 사용

mcp-brasil

제작: jxnxts · jxnxts/mcp-brasil

Query 41 Brazilian public APIs (legislative, judicial, fiscal, health, environment) in natural language — 363 tools, most need no API key.

mcp-brasil bundles 363 MCP tools spanning Brazilian government data: Câmara/Senado bills, STF/STJ rulings, Portal da Transparência spending, IBGE stats, BCB rates, DataSUS health, INPE environmental feeds. Ships with meta-tools like planejar_consulta and executar_lote to plan and parallelize multi-API investigations.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

brasil.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "brasil",
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "brasil": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-brasil"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add brasil -- uvx mcp-brasil

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: mcp-brasil

How to track a Brazilian bill through Câmara and Senado

👤 Journalists, policy analysts, government affairs teams ⏱ ~15 min beginner

언제 쓸까: You need to follow a specific proposition (PL/PEC) across votes, amendments, and committee stages without scraping websites.

사전 조건
  • The bill identifier (e.g. PL 2630/2020) — From a Câmara/Senado URL or news article
흐름
  1. Find the proposition and its current status
    Use mcp-brasil to find PL 2630/2020 in Câmara. Show current status, author, and tramitação timeline.✓ 복사됨
    → Structured response with bill metadata and stage history
  2. Pull votes and committee actions
    List every vote and committee action on that bill, with dates and results.✓ 복사됨
    → Chronological list of events
  3. Summarize for a briefing
    Write a 3-paragraph briefing: where the bill stands today, who's pushing it, and the most likely next step.✓ 복사됨
    → Ready-to-publish policy summary

결과: A sourced legislative brief built from primary Câmara/Senado data in under 10 minutes.

함정
  • Bill IDs collide across houses — PL in Câmara ≠ PLS in Senado — Always specify the house; use planejar_consulta to query both if uncertain
함께 쓰기: notion

Audit Brazilian government contracts with mcp-brasil

👤 Investigative reporters, transparency NGOs ⏱ ~40 min advanced

언제 쓸까: You suspect irregular spending by a federal body and want to cross-check Portal da Transparência, sanctions registry, and contract data.

사전 조건
  • Free Portal da Transparência API key — api.portaldatransparencia.gov.br — takes a minute, set TRANSPARENCIA_API_KEY
흐름
  1. List recent contracts for the target entity
    Get the top 20 largest contracts signed by Ministério X in the last 12 months, with supplier CNPJs.✓ 복사됨
    → Table of contracts with values and CNPJs
  2. Check suppliers against the sanctions registry (CEIS/CEPIM)
    For each CNPJ, check if it appears in CEIS or CEPIM sanctions. Flag matches.✓ 복사됨
    → Supplier-by-supplier compliance status
  3. Cross-reference with public servant data
    Use executar_lote to parallelize partner lookups across all flagged CNPJs.✓ 복사됨
    → Potential conflict-of-interest leads

결과: A data-backed lead list you can hand to a legal or journalistic team for verification.

함정
  • Hitting Transparência rate limits mid-audit — Throttle with batch size 10; executar_lote handles back-off
  • Treating surname matches as proof — Always verify manually — this is lead generation, not conclusion
함께 쓰기: google-sheets

Build a live Brazilian macro dashboard with mcp-brasil

👤 Economists, fintech PMs, analysts ⏱ ~10 min beginner

언제 쓸까: You need daily SELIC, IPCA, câmbio without wiring BCB/IBGE APIs manually.

흐름
  1. Pull today's key rates
    Give me today's SELIC, CDI, IPCA (12m), USD/BRL using mcp-brasil.✓ 복사됨
    → Current values with source + timestamp per indicator
  2. Render a morning note
    Write a morning note comparing today's values to 30 days ago, flag >1 sigma moves.✓ 복사됨
    → Formatted note ready to paste in Slack

결과: A self-refreshing macro snapshot you can schedule daily.

함께 쓰기: google-sheets

조합

다른 MCP와 조합해 10배 효율

brasil + google-sheets

Dump contract audits or macro snapshots straight into a shared sheet

Run today's macro snapshot with mcp-brasil and append the row to my 'Brasil Macro' Google Sheet.✓ 복사됨
brasil + notion

Policy tracking workspace with each bill as a Notion page

For every active PL in Comissão X, create/update a Notion page with the latest tramitação.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
planejar_consulta question: str Start of any cross-API investigation — lets the server pick the right endpoints 1 local call
executar_lote calls: Call[] You have a list of CNPJs/CPFs/bill IDs to enrich in one shot N upstream calls parallelized
listar_features Discover what domains are covered before drafting a prompt 0
recomendar_tools query: str You know what you want but not which of the 363 tools fits 0

비용 및 제한

운영 비용

API 쿼터
Upstream varies: Câmara/Senado effectively unlimited; Transparência ~90 req/min per key; IBGE/BCB generous
호출당 토큰
100–1500 depending on endpoint
금액
Free — all underlying APIs are public
팁
Use planejar_consulta first to avoid firing 10 tools when 2 suffice

보안

권한, 시크릿, 파급범위

자격 증명 저장: Optional keys in env vars TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, META_ACCESS_TOKEN
데이터 외부 송신: Calls go to Brazilian government domains (gov.br, ibge.gov.br, bcb.gov.br) and Meta Ad Library

문제 해결

자주 발생하는 오류와 해결

429 Too Many Requests (Portal da Transparência)

Reduce batch size in executar_lote to 5 and add pauses; Transparência is the strictest upstream

확인: Re-run the same call after 60s
Tool not found / unknown feature

Run listar_features then recomendar_tools with your natural-language query — the 363-tool surface requires discovery

Empty result for a valid CNPJ

Not all CNPJs appear in every registry; check Receita Federal base first

대안

mcp-brasil 다른 것과 비교

대안언제 쓰나단점/장점
BrasilAPIYou only need CEP/CNPJ/banks and want a single HTTP callTiny surface compared to mcp-brasil's 363 tools
Direct gov.br API callsYou're building a production backend, not an AI agent workflowYou write all the plumbing yourself

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기