Name: mcp-dev-brasil
Author: codespar

Das Problem

KI-Agenten können Code schreiben, Daten analysieren und chatten. Aber sie können kein Unternehmen betreiben — Zahlungen entgegennehmen, Rechnungen ausstellen, Produkte versenden oder Kunden benachrichtigen. Besonders nicht in Brasilien, wo jeder Dienst seine eigene API, sein eigenes Authentifizierungsmuster und seine eigenen Eigenheiten hat.

Unterdessen werden fünf Kategorien agentischer Zahlungsinfrastruktur parallel veröffentlicht — Checkout-Protokolle, Autorisierungsebenen, Mikrozahlungswege, Identitäts-Frameworks und Ausgabetools — und keines davon lässt sich sauber kombinieren.

MCP Dev Brasil schließt beide Lücken. Traditionelle brasilianische Dienste + die neuen agentischen Zahlungsprotokolle, alles zugänglich über eine einzige MCP-Schnittstelle.

Die Lösung

MCP Brasil bietet KI-Agenten typisierte Tools für die Interaktion mit brasilianischen APIs und agentischen Zahlungsprotokollen. Jeder Server kapselt einen echten Dienst — Zahlungen, Steuern, Logistik, Messaging, Bankwesen, ERP, Krypto und jetzt agentische Protokolle —, sodass Ihr Agent einen vollständigen geschäftlichen Workflow abwickeln kann.

🛒 Customer places order
  → 💳 Agent charges via Pix (Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal)
  → 📦 Agent generates shipping label (Melhor Envio)
  → 📱 Agent sends tracking via WhatsApp (Z-API)
  → 📊 Agent records in ERP (Omie)
  → 🏦 Agent reconciles balance (Stark Bank)

Sechs Systeme. Null menschliches Eingreifen. Ein Agent.

Agentische Zahlungsprotokolle

"Die Brücke sieht eher wie Middleware aus als wie ein Protokoll." — Die Middleware ist MCP.

Drei neue Server, die den aufstrebenden agentischen Zahlungs-Stack überbrücken:

Protokoll	Server	Tools	Was es tut
Google UCP	`@codespar/mcp-ucp`	21	Universal Commerce Protocol — agentisches Einkaufen, Warenkorb, Checkout, Bestellungen, Lieferung, Identität. Googles vollständiger Handels-Stack für KI-Agenten.
Stripe ACP	`@codespar/mcp-stripe-acp`	16	Agentic Commerce Protocol — KI-Agenten-Checkout, Zahlungsdelegierung, Produkte, Rechnungen. Live in ChatGPT mit über 1 Mio. Shopify-Händlern.
x402	`@codespar/mcp-x402`	10	HTTP-native Mikrozahlungen von Coinbase — wenn ein Agent auf einen 402-Fehler stößt, zahlt er USDC auf Base/Solana und versucht es erneut. Reines HTTP, keine Checkout-UI.
AP2	`@codespar/mcp-ap2`	13	Googles Agent-to-Agent Payment Protocol — Autorisierung, Audit-Trails, begrenzte Ausgabenlimits. 60+ Partner, darunter Visa, Mastercard, Stripe, PayPal.

Das Autonomie-Spektrum

Jedes Protokoll befindet sich auf einer anderen Ebene der Agenten-Autonomie:

 Human-in-loop ◄──────────────────────────────► Fully autonomous

  ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
  │   ACP   │   │   UCP   │   │   AP2   │   │   x402  │
  │ Stripe  │   │ Google  │   │ Google  │   │Coinbase │
  └─────────┘   └─────────┘   └─────────┘   └─────────┘
  User confirms   Commerce     User sets      No user.
  every purchase  lifecycle    rules, agent   Machine-to-
  in-chat         managed      acts within    machine at
                  by agent     budget/scope   HTTP layer

Der Konvergenz-Stack

Diese Protokolle konkurrieren nicht — sie konvergieren zu Ebenen:

┌─────────────────────────────────────────────┐
│  Application Layer        ACP / UCP         │  Chat UX, product discovery
├─────────────────────────────────────────────┤
│  Authorization Layer      AP2 / Mandates    │  Spend limits, audit trails
├─────────────────────────────────────────────┤
│  Tool Layer               MCP  ◄── WE ARE  │  Standardized agent tools
├─────────────────────────────────────────────┤
│  Settlement Layer         x402 / Pix / Card │  On-chain or traditional rails
└─────────────────────────────────────────────┘

CodeSpar befindet sich auf der Tool-Ebene — der Middleware, die jedes Anwendungs-, Autorisierungs- und Abwicklungsprotokoll über eine einzige Schnittstelle verbindet.

Warum das wichtig ist

Agent needs to buy something
  ├── Full commerce?       → Google UCP (search → cart → checkout → delivery)
  ├── Retail checkout?     → Stripe ACP (create_checkout → complete_checkout)
  ├── API micropayment?    → x402 (pay_request → USDC $0.001 → data returned)
  ├── Agent-to-agent?      → AP2 (authorize_payment → execute_payment)
  └── Brazilian merchant?  → Asaas / Zoop / PagSeguro (traditional rails)

All via MCP. Same interface. One agent.

Schnellstart — Agentische Protokolle

# Google UCP — full agentic commerce (early access)
npx @codespar/mcp-ucp

# Stripe ACP — agentic checkout (test mode, free)
npx @codespar/mcp-stripe-acp

# x402 — HTTP micropayments (testnet, free)
npx @codespar/mcp-x402

# AP2 — agent authorization (early access)
npx @codespar/mcp-ap2

Schnellstart

Mit Claude Desktop

Hinzufügen zu ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_..."
      }
    },
    "zoop": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zoop"],
      "env": {
        "ZOOP_API_KEY": "your-api-key",
        "ZOOP_MARKETPLACE_ID": "your-marketplace-id"
      }
    }
  }
}

Mit jedem MCP-Client

npx @codespar/mcp-stripe-acp   # Agentic Commerce Protocol
npx @codespar/mcp-x402         # HTTP micropayments
npx @codespar/mcp-ap2          # Agent authorization
npx @codespar/mcp-zoop         # Payments (marketplace, split)
npx @codespar/mcp-nuvem-fiscal # Fiscal
npx @codespar/mcp-melhor-envio # Logistics
npx @codespar/mcp-z-api        # WhatsApp
npx @codespar/mcp-omie         # ERP
npx @codespar/mcp-stark-bank   # Banking
npx @codespar/mcp-dev-brasil-api   # CEP, CNPJ (no key needed!)

Jetzt ausprobieren (kein API-Schlüssel erforderlich)

BrasilAPI ist kostenlos und öffentlich. Probieren Sie es in Ihrem Terminal aus:

npx @codespar/mcp-dev-brasil-api

Fragen Sie dann Ihren Agenten: "Was ist die Adresse für CEP 01001-000?" oder "Suche nach CNPJ 00.000.000/0001-91"

Der vollständige Kreislauf

Das ist es, was MCP Brasil anders macht — nicht einzelne Konnektoren, sondern ein vollständiger geschäftlicher Workflow über Branchen hinweg:

Schritt	Branche	Server	Was der Agent tut
1	💳 Zahlung	Zoop	Erstellt Pix-Belastung, teilt sie auf Verkäufer auf
2	📄 Steuern	Nuvem Fiscal	Stellt NFe/NFSe aus, wenn die Zahlung bestätigt ist
3	📦 Logistik	Melhor Envio	Berechnet Versandkosten, generiert Label
4	📱 Messaging	Z-API	Sendet Tracking-Code via WhatsApp
5	📊 ERP	Omie	Erfasst Bestellung, aktualisiert Inventar
6	🏦 Bankwesen	Stark Bank	Gleicht Saldo ab, erstellt Berichte

Um alle 6 Schritte mit Governance, Genehmigungsworkflows und Audit-Trails zu orchestrieren — verwenden Sie CodeSpar.

Server

⚡ Agentische Protokolle (4 Server)

Server	Tools	Beschreibung	Auth
Google UCP	21	Universal Commerce Protocol — Einkaufen, Warenkorb, Checkout, Bestellungen, Lieferung, Identität	UCP API-Schlüssel
Stripe ACP	16	Agentic Commerce Protocol — Checkout-Sitzungen, Zahlungsdelegierung, Produkte, Rechnungen	Stripe API-Schlüssel
x402	10	HTTP-Mikrozahlungen — USDC auf Base/Solana, Paywalls, Maschine-zu-Maschine	Facilitator-Schlüssel
AP2	13	Agenten-Autorisierung, Audit-Trails, begrenzte Ausgabenlimits	AP2 API-Schlüssel

💳 Zahlungen (13 Server)

Server	Tools	Beschreibung	Auth
Asaas	10	Abrechnung, Pix, Boleto, Abonnements, Überweisungen	API-Schlüssel
PagSeguro	10	Bestellungen, Belastungen, Pix QR, Rückerstattungen	Bearer-Token
iugu	8	Rechnungen, Abonnements, Zahlungsmethoden	Basic Auth
Pix BCB	8	Offizielle Zentralbank Pix API (cob, DICT)	OAuth2 + mTLS
Zoop	20	Marktplatz-Zahlungen, Split-Regeln, Verkäufer, Abonnements	Basic Auth
Pagar.me	10	Bestellungen, Belastungen, Empfänger, Überweisungen	Basic Auth
EBANX	7	Grenzüberschreitende Zahlungen, Auszahlungen, Wechselkurse	Integrationsschlüssel
EFÍ/Gerencianet	8	Pix, Boleto, Carnet, Open Finance	OAuth2
Vindi	10	Wiederkehrende Abrechnung, Abonnements, Rechnungen	API-Schlüssel
Cielo	8	Kreditkarte, Debit, Boleto, wiederkehrende Zahlungen	Händlerschlüssel
Stone	8	Open Banking, Zahlungen, Pix, Überweisungen	OAuth2
Celcoin	8	Pix, Boleto, Überweisungen, Rechnungszahlungen, Aufladungen	OAuth2
AP2	13	Googles Agent-to-Agent Payment Protocol	AP2 API-Schlüssel

📄 Steuern (3 Server)

Server	Tools	Beschreibung	Auth
Focus NFe	8	NFe/NFSe/NFCe-Ausstellung und -Verwaltung	Basic Auth
Nuvem Fiscal	10	NFe/NFSe/NFCe, CNPJ/CEP-Suche	OAuth2
Conta Azul	10	Buchhaltung, Rechnungsstellung, Kunden, Produkte	OAuth2

📱 Kommunikation (5 Server)

Server	Tools	Beschreibung	Auth
Evolution API	10	WhatsApp-Automatisierung (Baileys)	API-Schlüssel
Z-API	20	WhatsApp-Messaging, Kontakte, Gruppen, Labels	Instanz + Token
Zenvia	8	Multichannel (SMS, WhatsApp, RCS)	API-Token
RD Station	8	Marketing-Automatisierung, CRM, Leads	Bearer-Token
Take Blip	8	Chatbots, Messaging, Kontakte, Broadcasts	Zugriffsschlüssel

🇧🇷 Identität (1 Server)

Server	Tools	Beschreibung	Auth
BrasilAPI	10	CEP, CNPJ, Banken, Feiertage, FIPE, DDD, Wetter	Keine (kostenlos)

🏦 Bankwesen (2 Server)

Server	Tools	Beschreibung	Auth
Stark Bank	10	Überweisungen, Boleto, Rechnungen, Pix, Saldo	Zugriffstoken
Open Finance	8	Open Finance Brasil — Konten, Transaktionen, Zustimmungen, Investitionen	OAuth2

📦 E-Commerce / Logistik (3 Server)

Server	Tools	Beschreibung	Auth
Melhor Envio	18	Versandangebote, Tracking, Labels, Warenkorb, Agenturen	Bearer-Token
Correios	6	Tracking, Versandberechnung, CEP	OAuth
VTEX	10	E-Commerce, Bestellungen, Produkte, Inventar, Versand	App-Schlüssel + Token

📊 ERP (3 Server)

Server	Tools	Beschreibung	Auth
Omie	10	Kunden, Produkte, Bestellungen, Rechnungen, Finanzen	App-Schlüssel + Secret
Bling	10	ERP, Produkte, Bestellungen, Rechnungen, Bestandsverwaltung	OAuth2
Tiny	10	ERP, Produkte, Bestellungen, Rechnungen, Bestand, Verbindlichkeiten	API-Token

🪙 Krypto / Stablecoins (5 Server)

Server	Tools	Beschreibung	Auth
x402	10	HTTP-Mikrozahlungen — USDC auf Base/Solana	Facilitator-Schlüssel
UnblockPay	10	Fiat-zu-Stablecoin Onramp/Offramp, Wallets, Überweisungen	API-Schlüssel
Circle	10	USDC-Zahlungen, Wallets, Auszahlungen, Überweisungen	API-Schlüssel
Mercado Bitcoin	10	Brasilianische Krypto-Börse, Handel, Orderbuch, Auszahlungen	API-Schlüssel + Secret
Bitso	10	Lateinamerikanische Krypto-Börse, Handel, Finanzierung, Auszahlungen	API-Schlüssel + Secret

🌎 LATAM-weit (4 Server)

Server	Tools	Beschreibung	Auth
Mercado Libre	14	LATAM-Marktplatz (18 Länder) — Produkte, Bestellungen, Verkäufer, Lieferungen	OAuth2
Mercado Pago	12	LATAM-Zahlungen — Karten, PIX, Checkout, Rückerstattungen	Bearer-Token
Nubank	10	Brasilianische Neobank via Open Finance — Konten, PIX, Transaktionen	OAuth2
Banco Inter	12	Brasilianische Digitalbank — Boleto, PIX, Kontoauszüge, Überweisungen	OAuth2

🇲🇽 Mexiko (6 Server)

Server	Tools	Beschreibung	Auth
Conekta	10	Zahlungs-Gateway —

mcp-dev-brasil