MCP Brasil — Anwendungsfälle, Installieren & Live-Demo

Name: MCP Brasil MCP Server
Author: Mcp-Brasil

Warum nutzen

Hauptfunktionen

Über 70 brasilianische öffentliche APIs vereint
Für das Open-Data-Subset keine API-Keys erforderlich
ViaCEP / BrasilAPI / OpenCEP Fallback-Kette, damit CEP-Suchen immer gelingen
Receita-Federal-CNPJ-Suche mit automatischem Rate-Limit-Handling
BCB-Tageswechselkurse und SELIC-Zeitreihen
Von einer brasilianischen Entwickler-Community gepflegt

Live-Demo

In der Praxis

mcp-brasil.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-brasil",
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-brasil": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-brasil"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add mcp-brasil -- uvx mcp-brasil

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: MCP Brasil

So führst du eine CNPJ-basierte Due-Diligence-Prüfung eines brasilianischen Geschäftspartners durch

👤 Brasilianische B2B-Verkäufer, Anwälte, Fintech-Ops ⏱ ~10 min intermediate

Wann einsetzen: Du stehst kurz vor dem Vertragsabschluss mit einem Anbieter und möchtest Rechtsstatus, Partner und Adresse aus offiziellen Quellen bestätigen.

Voraussetzungen

CNPJ des Geschäftspartners — 14-stellige Nummer, mit oder ohne Formatierung

Ablauf

CNPJ-Profil abrufen

Use mcp-brasil. Look up CNPJ 33.000.167/0001-01 and tell me legal name, status (ATIVA?), CNAE, capital social, partners.✓ Kopiert

→ Strukturiertes Profil mit allen Feldern
Adresse gegenchecken

Take the registered CEP. Resolve via ViaCEP. Does the city match what Receita reports?✓ Kopiert

→ Übereinstimmung oder Abweichung gekennzeichnet
Sanktionsprüfung

Check the partners' CPFs against any sanction lists this MCP exposes. Anything?✓ Kopiert

→ Liste der Treffer oder ‚keine Einträge'

Ergebnis: Ein einseitiges Due-Diligence-Memo zum Geschäftspartner aus offiziellen Quellen in 2 Minuten.

Fallstricke

Receita begrenzt aggressive Massenabfragen — Das Tool führt bereits Retry mit Backoff durch; bei Batches über 20 manuell verteilen

Kombinieren mit: filesystem

Einen Batch brasilianischer Adressen (CEP) vor dem Versand validieren

👤 Logistik, E-Commerce, CRM-Bereinigung ⏱ ~15 min beginner

Wann einsetzen: Du hast eine CSV mit Kundenadressen und CEPs und möchtest sie vor dem Drucken von 5.000 Etiketten bereinigen.

Voraussetzungen

addresses.csv mit CEP-Spalte — Beliebige CSV; Claude erkennt die Spalte automatisch

Ablauf

Validieren

Use mcp-brasil. For every CEP in /data/addresses.csv, fetch via ViaCEP. Append city, state, neighborhood. Flag CEPs that don't resolve.✓ Kopiert

→ validated.csv mit neuen Spalten und Markierungsspalte
Abgleichen

For mismatches between CRM city and ViaCEP city, suggest the corrected city.✓ Kopiert

→ Diff-Bericht

Ergebnis: Eine saubere Adressliste mit Quellenangabe pro Zeile.

Fallstricke

Manche CEPs sind ‚genéricos' (für ganze Städte) — ViaCEP gibt diese ohne Stadtviertel zurück — das ist erwartet, kein Fehler

Kombinieren mit: filesystem

IBGE-Indikatoren für eine Brasilien-fokussierte Datenanalyse abrufen

👤 Datenanalysten, die mit brasilianischen Märkten arbeiten ⏱ ~20 min intermediate

Wann einsetzen: Du benötigst Bevölkerungs-, BIP-pro-Kopf- oder HDI-Daten pro Município oder Estado.

Ablauf

Indikatoren auflisten

List IBGE indicators available via mcp-brasil related to GDP per capita.✓ Kopiert

→ Indikatorkatalog
Zeitreihe auf Staatsebene abrufen

Fetch GDP per capita for all 27 estados, latest year. Output to /data/gdp.csv.✓ Kopiert

→ CSV mit 27 Zeilen
Wechselkurs einbeziehen

Convert to USD using BCB's official rate as of the same year. Add column.✓ Kopiert

→ USD-Spalte eingefügt

Ergebnis: Reproduzierbarer Datensatz auf Staatsebene, bezogen aus IBGE und BCB.

Fallstricke

IBGE-Indikator-IDs ändern sich gelegentlich — Immer mit dem Katalog-Tool starten; keine IDs hard-coden

Kombinieren mit: filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mcp-brasil + filesystem

CSVs mit Adressen oder CNPJs stapelweise validieren

mcp-brasil + postgres

Eine Postgres-Tabelle mit öffentlichen Datenspalten anreichern

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
viacep	cep: str	Einen brasilianischen CEP auflösen	kostenlos
cnpj_lookup	cnpj: str	Ein brasilianisches Unternehmen verifizieren	kostenlos (Rate-limitiert durch Receita)
bcb_rate	currency: str, date?: str	Offiziellen BRL-Umrechnungskurs benötigen (z. B. für die Buchhaltung)	kostenlos
ibge_indicator	indicator_id: str, geo_level: 'br'\|'uf'\|'municipio', year?: int	Offizielle Statistiken abrufen	kostenlos
inpi_search	query: str, kind: 'patent'\|'trademark'	Marken- / Patent-Prior-Art-Prüfung	kostenlos

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Pro Quelle: ViaCEP unbegrenzt, Receita ~3 Anfragen/min, BCB unbegrenzt
Tokens pro Aufruf: 100–500
Kosten in €: Kostenlos
Tipp: Für Receita-intensive Jobs Antworten als lokales JSON für den Tag zwischenspeichern

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Keine für Open-Data-APIs

Datenabfluss: Jeder Aufruf geht an die zugrundeliegende offizielle API (viacep.com.br, Receita, BCB, IBGE usw.)

Beim Übergeben von CPFs/CNPJs realer Personen diese wie personenbezogene Daten behandeln — genau wie jeden anderen Identifikator

Fehlerbehebung

Häufige Fehler und Lösungen

Receita-CNPJ-Suche gibt 429 zurück

Rate-Limit erreicht. Tool versucht es einmal erneut; andernfalls 60 Sekunden warten.

Prüfen: Einzelne Suche nach Wartezeit erfolgreich

ViaCEP gibt erro: true zurück

CEP existiert nicht oder ist fehlerhaft formatiert — Format ddddd-ddd prüfen

IBGE-Indikator liefert keine Daten für ein Jahr

Manche Indikatoren haben Mehrjahreskadenz; verfügbare Periodos über den Katalog abfragen

Alternativen

MCP Brasil vs. andere

Alternative	Wann stattdessen	Kompromiss
BrasilAPI (direktes REST)	Du möchtest einen einzelnen Endpunkt ohne MCP-Schicht aufrufen	BrasilAPI allein ist eine CEP/CNPJ-Quelle; mcp-brasil aggregiert über 70
Receita Federal direkt	Du brauchst die maßgeblichsten CNPJ-Daten und kannst mit dem Captcha-Workflow umgehen	Schlechte UX; mcp-brasil nutzt gecachte Open-Data-Mirrors

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen