SERVEUR MCP

Outils de portefeuille d'agent pour tout client MCP.

Le serveur MCP officiel de Blockchain0x donne à un agent compatible MCP la capacité de lire des wallets, d'envoyer des USDC sur Base et de régler des factures. Connectez-vous au point de terminaison hébergé, ou exécutez-le localement avec une seule commande.

https://mcp.blockchain0x.com/mcp

CE QUE C'EST

Un serveur. Cinq outils. Tous les clients MCP.

Le Model Context Protocol est la manière standard dont les clients AI - Claude Desktop, Cursor, Cline et autres - appellent des outils externes. Le serveur Blockchain0x MCP expose vos wallets d'agents via ce standard, afin que n'importe quel client MCP puisse transférer de l'argent sans que vous ayez à écrire une intégration personnalisée.

Le serveur est un proxy léger et sans état au-dessus de l'API Blockchain0x. Il ne conserve ni fonds ni base de données ; il transmet chaque appel d'outil à l'API en utilisant la clé que vous fournissez, et l'autorisation de dépense de chaque agent limite toujours ce qu'un outil peut faire.

LES OUTILS

Ce que l'agent peut appeler.

get_wallet

Lisez le portefeuille d'un agent - adresse, solde USDC sur Base et métadonnées.

list_wallets

Listez les portefeuilles d'agents dans votre espace de travail.

get_transaction

Recherchez une transaction par son id et consultez son statut on-chain.

send_payment

Envoyez des USDC depuis le portefeuille d'un agent sur Base, dans la limite de son autorisation de dépense.

settle_payment_request

Réglez une demande de paiement que vous avez créée dans le tableau de bord, avec preuve on-chain.

COMMENT L’UTILISER

Deux façons de se connecter.

1. Hébergé (Streamable HTTP)

Pointez votre client MCP vers le point de terminaison hébergé et transmettez votre clé API en tant qu'en-tête Bearer. Rien à installer.

CONFIGURATION DU CLIENT MCP (HÉBERGÉ)

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

2. Local (stdio, via npx)

Exécutez le serveur sur votre propre machine avec npx @blockchain0x/mcp. Votre clé reste dans votre environnement et ne quitte jamais votre appareil.

CONFIGURATION DU CLIENT MCP (STDIO)

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

Commencez avec une clé sk_test_ sur Base Sepolia, puis passez à sk_live_. La configuration complète est dans la documentation ; pour monétiser vos propres outils MCP, consultez la recette d'intégration MCP.

SÉCURITÉ

L'autorisation de dépense continue de s'appliquer.

Le serveur ne détient jamais vos fonds ni vos clés ; il transmet chaque appel à l'API Blockchain0x.
send_payment est vérifié par rapport au plafond par transaction de l'agent et à son quota par période avant règlement, comme n'importe quel autre appel API.
Utilisez une clé en lecture seule (sans scope pay) pour un agent qui doit uniquement lire les wallets et les transactions.
En stdio, la clé reste dans votre environnement local. En hébergé, elle transite comme en-tête Bearer via TLS et n'est pas stockée.

QUESTIONS FRÉQUEMMENT POSÉES

Trois questions sur le serveur MCP.

Où s'exécute le serveur MCP, et voyez-vous ma clé ?

Deux façons de l'exécuter. Hébergé : connectez votre client MCP au point de terminaison Streamable HTTP et envoyez votre clé API comme en-tête Bearer à chaque requête ; le serveur est un proxy sans état qui relaie les appels vers l'API Blockchain0x. Local (stdio) : exécutez npx @blockchain0x/mcp sur votre propre machine et votre clé reste dans votre environnement, sans jamais quitter votre appareil. Choisissez stdio si vous préférez ne pas envoyer la clé vers un point de terminaison hébergé.

Quelle clé API dois-je utiliser ?

Une clé sk_test_ fonctionne sur Base Sepolia (testnet) afin que vous puissiez connecter les outils sans déplacer de fonds réels ; passez à une clé sk_live_ pour le mainnet. Les scopes de la clé déterminent ce que les outils peuvent faire - une clé en lecture seule peut appeler get_wallet, list_wallets et get_transaction, mais pas send_payment.

Est-ce la même chose que le helper requirePayment ?

Non. Cette page concerne le serveur MCP Blockchain0x, qui fournit à un client MCP des outils de portefeuille d'agent (lire les portefeuilles, envoyer des USDC, régler des factures). requirePayment est un helper distinct dans @blockchain0x/mcp que vous utilisez pour monétiser VOS propres outils MCP en renvoyant un challenge x402 402. Consultez la recette d'intégration MCP pour cela.

Donnez un portefeuille à votre client MCP.

Créez un portefeuille d'agent, récupérez une clé, puis connectez votre client au serveur. Gratuit pour commencer.