MCP SERVER

Agent-Wallet-Tools für jeden MCP-Client.

Der offizielle Blockchain0x MCP Server gibt einem MCP-fähigen Agenten die Möglichkeit, Wallets zu lesen, USDC auf Base zu senden und Rechnungen zu begleichen. Verbinde den gehosteten Endpunkt oder starte ihn lokal mit einem Befehl.

https://mcp.blockchain0x.com/mcp

WAS ES IST

Ein Server. Fünf Tools. Jeder MCP-Client.

Das Model Context Protocol ist der Standardweg, über den AI-Clients - Claude Desktop, Cursor, Cline und andere - externe Tools aufrufen. Der Blockchain0x MCP Server stellt deine Agent Wallets über diesen Standard bereit, sodass jeder MCP-Client Geld bewegen kann, ohne dass du eine eigene Integration schreiben musst.

Der Server ist ein schlanker, zustandsloser Proxy über der Blockchain0x API. Er hält weder Gelder noch eine Datenbank; er leitet jeden Tool-Aufruf mit dem von dir bereitgestellten Key an die API weiter, und die Spend-Berechtigung jedes Agenten begrenzt weiterhin, was ein Tool tun kann.

DIE TOOLS

Was der Agent aufrufen kann.

get_wallet

Lies die Wallet eines Agents aus: Adresse, USDC-Guthaben auf Base und Metadaten.

list_wallets

Liste die Agent-Wallets in deinem Workspace auf.

get_transaction

Suche eine Transaktion anhand ihrer ID und lies ihren On-chain-Status aus.

send_payment

Sende USDC aus der Wallet eines Agents auf Base, innerhalb seiner Ausgabenberechtigung.

settle_payment_request

Begleiche eine im Dashboard erstellte Zahlungsanfrage mit On-chain-Nachweis.

SO VERWENDEST DU ES

Zwei Möglichkeiten zur Verbindung.

1. Gehostet (Streamable HTTP)

Richte deinen MCP-Client auf den gehosteten Endpunkt und übergib deinen API-Key als Bearer-Header. Nichts zu installieren.

MCP CLIENT CONFIG (GEHOSTET)

{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

2. Lokal (stdio, via npx)

Führe den Server auf deinem eigenen Rechner mit npx @blockchain0x/mcp aus. Dein Schlüssel bleibt in deiner Umgebung und verlässt dein Gerät nie.

MCP CLIENT KONFIGURATION (STDIO)

{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["@blockchain0x/mcp"],
      "env": { "BLOCKCHAIN0X_API_KEY": "sk_live_..." }
    }
  }
}

Starte mit einem sk_test_-Key gegen Base Sepolia und wechsle dann zu sk_live_. Die vollständige Einrichtung findest du in den Docs; um deine eigenen MCP-Tools zu bepreisen, sieh dir das MCP-Integrationsrezept an.

SICHERHEIT

Die Spend-Berechtigung gilt weiterhin.

Der Server hält niemals deine Gelder oder deine Keys; er leitet jeden Aufruf an die Blockchain0x API weiter.
send_payment wird vor der Abrechnung gegen das per-transaction cap und das per-period allowance des Agenten geprüft, genau wie jeder andere API-Aufruf.
Verwende einen Read-only-Key (kein pay scope) für einen Agenten, der nur Wallets und Transaktionen lesen soll.
Bei stdio bleibt der Schlüssel in deiner lokalen Umgebung. Bei hosted wird er als Bearer-Header über TLS übertragen und nicht gespeichert.

HÄUFIG GESTELLTE FRAGEN

Drei Fragen zum MCP Server.

Wo läuft der MCP Server, und seht ihr meinen Key?

Zwei Möglichkeiten zum Betrieb. Gehostet: Verbinde deinen MCP-Client mit dem Streamable-HTTP-Endpunkt und sende deinen API-Key bei jeder Anfrage als Bearer-Header; der Server ist ein zustandsloser Proxy, der Aufrufe an die Blockchain0x API weiterleitet. Lokal (stdio): Führe npx @blockchain0x/mcp auf deinem eigenen Rechner aus und dein Key bleibt in deiner Umgebung, ohne jemals dein Gerät zu verlassen. Wähle stdio, wenn du den Key lieber nicht an einen gehosteten Endpunkt senden möchtest.

Welchen API-Key soll ich verwenden?

Ein sk_test_-Key läuft gegen Base Sepolia (Testnet), damit du die Tools einrichten kannst, ohne echtes Geld zu bewegen; wechsle für Mainnet zu einem sk_live_-Key. Die Scopes des Keys entscheiden, was die Tools können - ein Read-only-Key kann get_wallet, list_wallets und get_transaction aufrufen, aber nicht send_payment.

Ist das dasselbe wie der requirePayment-Helper?

Nein. Diese Seite handelt vom Blockchain0x MCP-Server, der einem MCP-Client Agent-Wallet-Tools bereitstellt (Wallets lesen, USDC senden, Rechnungen begleichen). requirePayment ist ein separater Helper in @blockchain0x/mcp, mit dem du deine EIGENEN MCP-Tools bepreisen kannst, indem du einen x402-402-Challenge zurückgibst. Sieh dir dafür das MCP-Integrationsrezept an.

Gib deinem MCP-Client ein Wallet.

Erstelle ein Agent-Wallet, hol dir einen Key und richte deinen Client auf den Server aus. Kostenlos loslegen.