basezap-mcp

Ein MCP (Model Context Protocol) Server, der die BaseZap Trinkgeld-Agent Tools für jeden MCP-Client bereitstellt — Claude Desktop, Cursor, Claude Code usw.

Dieser Server ist ausschließlich lesend / nicht-verwahrend ausgelegt: Er hält niemals private Schlüssel, signiert nie etwas und sendet nie eine Transaktion. Er ruft nur Plattforminformationen ab, berechnet Gebührenangebote und erstellt unsignierte ERC-20-Transfer- Calldata, die von einem separaten, mit einer Wallet verbundenen Client signiert und gesendet werden muss.

Tools

• get_platform_info — Chain, USDC-Adresse, Plattformgebühr (BPS), Gebühren-Wallet.

• get_tip_quote — Gibt bei einem USDC-Betrag die genaue Aufteilung der Urheber-/Plattformgebühr zurück.

• build_tip_calldata — Gibt bei einer Empfängeradresse + Betrag unsignierte Calldata für beide Seiten eines Trinkgelds zurück. Signiert oder sendet nie etwas.

• resolve_farcaster_username — Löst einen Farcaster-Benutzernamen in seine verifizierte Wallet-Adresse auf (verwendet direkt den /api/resolve-user Endpunkt von BaseZap).

Related MCP server: x402-bazaar-mcp

Installation

npm install --ignore-scripts
npm run build

(--ignore-scripts vermeidet Probleme beim Bau nativer Module in manchen Umgebungen, z. B. Termux/Android — überall harmlos verwendbar.)

Eigenständig ausführen (zum Testen)

npm start

Oder einen einzelnen Tool-Aufruf direkt über stdio ohne MCP-Client testen:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_tip_quote","arguments":{"amountUsdc":1}}}' | node build/index.js

Claude Desktop Konfiguration

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu (Einstellungen → Entwickler → Konfiguration bearbeiten):

{
  "mcpServers": {
    "basezap": {
      "command": "node",
      "args": ["/absolute/path/to/basezap-mcp/build/index.js"],
      "env": {
        "BASEZAP_USE_X402": "false"
      }
    }
  }
}

Ersetzen Sie den Pfad durch den tatsächlichen absoluten Pfad zu build/index.js auf Ihrem Rechner. Starten Sie Claude Desktop nach dem Bearbeiten der Konfiguration neu.

Kostenloser vs. kostenpflichtiger (x402) Modus

Standardmäßig (BASEZAP_USE_X402=false oder nicht gesetzt) ruft der Server den kostenlosen Endpunkt von BaseZap (/api/agent) auf. Setzen Sie BASEZAP_USE_X402=true, um Aufrufe stattdessen über den kostenpflichtigen x402-Endpunkt zu leiten (0,001 USDC pro Aufruf).

Wichtig: Die alleinige Einstellung BASEZAP_USE_X402=true bringt den Server NICHT dazu, automatisch zu bezahlen — Sie erhalten bei jedem Aufruf eine klare HTTP 402 Payment Required-Fehlermeldung, es sei denn, Sie haben separat eine automatische Zahlung eingerichtet (siehe unten) oder verwenden einen MCP-Client/Gateway, der die x402-Zahlung bereits für Sie abwickelt.

Optional: x402 automatische Zahlung

Siehe AUTOPAY.md für eine Schritt-für-Schritt-Anleitung, wie dieser Server seine eigenen x402-Gebühren automatisch mit einer finanzierten Wallet bezahlen kann. Lesen Sie es sorgfältig, bevor Sie es verwenden — es erfordert, einen echten privaten Schlüssel in eine Umgebungsvariable zu setzen, und ein falsch konfigurierter Auto-Pay-Server kann bei jedem Tool-Aufruf stillschweigend echtes Geld ausgeben. Es ist standardmäßig NICHT eingebunden, und Sie sollten genau verstehen, was es tut, bevor Sie es aktivieren.

Überprüfter Anfragevertrag

Die genaue Anfrage-/Antwortstruktur, auf die sich dieser Server stützt, wurde live gegen den echten /api/agent Endpunkt bestätigt (nicht aus der Dokumentation angenommen):

{ "tool": "get_tip_quote", "args": { "amount_usdc": 1 } }

gibt zurück:

{ "total_usdc": 1, "creator_receives_usdc": 0.95, "platform_fee_usdc": 0.05, "platform_fee_bps": 500 }

Beachten Sie, dass die API selbst snake_case Feldnamen innerhalb von args verwendet — die MCP-Tool-Eingaben dieses Servers verwenden benutzerfreundliches camelCase (amountUsdc) und übersetzen intern, daher ist dies nur relevant, wenn Sie den Server selbst modifizieren.