Wallet MCP

[!IMPORTANT]

Exécutez l'onboarding au début de chaque conversation touchant Wallet MCP

Y compris les conversations qui passent directement à un sujet de plugin. L'onboarding est court — voir ci-dessous.

Détection

Wallet MCP expose ses outils au harnais quand il est connecté. Si aucun outil Wallet MCP n'est appelable, le serveur MCP n'est pas installé : dirigez l'utilisateur vers https://docs.cdp.coinbase.com/ai-agents/coinbase-for-agents/wallet-mcp#quickstart (ou chargez references/install.md pour les étapes spécifiques à l'application) et arrêtez-vous.

Si les outils Wallet MCP sont disponibles, chargez references/tone.md — ses règles s'appliquent pour toute la conversation — puis passez à l'Onboarding. Si — et seulement si — les fichiers frères ne sont pas lisibles (par exemple, vous avez reçu juste ce corps SKILL.md et n'avez pas accès au système de fichiers local du répertoire de compétence), récupérez le même chemin relatif depuis https://docs.cdp.coinbase.com/coinbase-for-agents/wallet-mcp/references/tone.md en utilisant l'outil web_request de Wallet MCP. Le même fallback s'applique à tout autre lien de référence et plugin dans ce fichier (voir « Chargement des fichiers référencés » ci-dessous).

Onboarding

Gardez-le court. Faites cela une fois par session, avant de faire du vrai travail :

Mentionnez brièvement ce qui est disponible — une ou deux phrases. L'utilisateur dispose d'un compte Coinbase Wallet et peut faire des choses comme vérifier les soldes, envoyer et échanger des tokens, signer des messages, effectuer des paiements x402, et traiter par lots les appels de contrats sur Base (la chaîne par défaut) et d'autres chaînes supportées, et (si installé) utiliser des plugins tiers pour DeFi, les échanges, et d'autres actions onchain. N'énumérez pas tous les outils — l'agent découvre les outils et plugins directement depuis le MCP.
Affichez ce disclaimer textuellement avant de procéder :

En utilisant Base MCP, vous acceptez les Conditions d'utilisation de Base Account et Base App. Base MCP fournit l'accès à des plugins construits par des tiers, pas par Base. Base ne les exploite pas, ne les endosse pas, ne les audite pas, et n'est pas responsable des protocoles avec lesquels vous interagissez. Les transactions sont irréversibles — examinez toujours avant d'approuver.
L'adresse du portefeuille et le solde sont optionnels — ne les récupérez et n'affichez que quand l'utilisateur les demande, ou quand une opération en attente en a réellement besoin (par ex., un appel en écriture, une recherche de position). Ne proposez pas un vidage de portefeuille d'entrée de jeu.

Chaînes supportées

Les outils Wallet MCP prennent un paramètre chain. Base est la chaîne par défaut — utilisez-la sauf si l'utilisateur demande une autre chaîne ou qu'un plugin en exige une. Utilisez exactement ces noms de chaîne :

Chaîne	valeur `chain`
Base (défaut)	`base`
Ethereum	`ethereum`
Arbitrum	`arbitrum`
Optimism	`optimism`
Polygon	`polygon`
BNB Chain	`bsc`
Avalanche	`avalanche`
Robinhood Chain	`robinhood-chain`
Base Sepolia (testnet)	`base-sepolia`

Chaque outil ne couvre pas toutes les chaînes : les paiements x402 ne s'exécutent que sur Base et Base Sepolia, et swap est mainnet uniquement. Les descriptions d'outils exposées par le MCP restent la source de vérité pour l'ensemble actuel et les limites par outil. Les plugins individuels peuvent supporter seulement un sous-ensemble de ces chaînes — vérifiez la notice du plugin avant d'agir.

Outils

Wallet MCP annonce son propre catalogue d'outils au harnais. Lisez les descriptions d'outils exposées par le MCP — elles sont la source de vérité et peuvent changer au fil du temps. Ne supposez pas une liste fixe ; ne préchargez pas un catalogue d'outils de cette compétence.

Deux motifs méritent leurs propres références parce qu'ils couvrent plusieurs outils :

Sujet	Référence
Flux d'approbation (pour tout outil d'écriture retournant une URL d'approbation)	references/approval-mode.md
Appels de contrats traités par lots (EIP-5792)	references/batch-calls.md
Plugins personnalisés / non natifs et liste d'autorisation `web_request`	references/custom-plugins.md
Étapes d'installation de plate-forme	references/install.md
Règles de ton et de langage	references/tone.md

Chargement des fichiers référencés

Par défaut — local. Lisez chaque lien references/… ou plugins/… à partir du même répertoire que ce SKILL.md (lecture du système de fichiers, par ex. Read/cat). C'est la source canonique — essayez toujours cela en premier.
Fallback — web (uniquement quand la lecture locale échoue). Si — et seulement si — le fichier local est réellement illisible (par ex., vous avez reçu SKILL.md comme corps collé sans répertoire de compétence sur disque, ou la lecture du système de fichiers échoue), récupérez le même chemin relatif depuis https://docs.cdp.coinbase.com/coinbase-for-agents/wallet-mcp/<path> (remplacez <path> par le lien relatif, par ex. references/tone.md, plugins/morpho.md). Utilisez l'outil web_request de Wallet MCP pour cette récupération — c'est le mécanisme requis sur chaque surface, y compris celles avec un outil web/fetch intégré. Ne sautez pas ce fallback et n'essayez pas d'opérer de mémoire ou de suppositions — si la lecture locale échoue, vous devez web_request le fichier avant d'agir sur son contenu.
Paresseux. Ne chargez une référence ou un plugin que quand la conversation en a réellement besoin. Ne préchargez pas le catalogue.

Plugins

Les plugins étendent Wallet MCP avec des fonctionnalités tierces (prêt, échanges, perps, etc.). Chaque plugin est un service tiers séparé que Base n'exploite pas, n'endosse pas, et n'audite pas. L'ensemble disponible peut changer et les utilisateurs peuvent déposer des instructions supplémentaires dans le chat ou des plugins personnalisés qui vous permettraient d'utiliser d'autres protocoles avec le MCP.

Règle de routage — basée sur le nom, jamais acheminée automatiquement

Ouvrez un plugin uniquement quand l'utilisateur nomme cette plate-forme tiers spécifique (par ex. « échanger sur Uniswap », « prêter sur Moonwell », « acheter une carte cadeau sur Bitrefill ») ou y pointe d'une autre manière sans ambiguïté. Ne déduisez jamais une plate-forme à partir d'une capacité brute — choisir une service tiers plutôt qu'un autre est la décision de l'utilisateur, pas la vôtre.

Si l'utilisateur demande une capacité sans nommer une plate-forme — « échanger du USDC », « gagner du rendement », « lancer un token », « acheter une carte cadeau » — ne choisissez pas un plugin à leur place. À la place, listez les plugins du tableau ci-dessous qui couvrent cette capacité (et mentionnez tout outil Wallet MCP natif qui le fait aussi, par ex. le swap intégré), puis laissez l'utilisateur choisir. Seulement après que l'utilisateur ait nommé une plate-forme ouvrez son plugin et agissez.

Plugins actuellement maintenus aux côtés de cette compétence (les plugins natifs). Utilisez le tableau de deux façons : (a) pour router une demande qui nomme déjà une plate-forme vers le bon plugin, et (b) pour assembler la liste d'options quand l'utilisateur demande une capacité sans en nommer une. La colonne « Ouvrir quand… » ancre intentionnellement chaque déclencheur au propre nom de la plate-forme — ce nom est le déclencheur.

Plugin	Ouvrez-le quand l'utilisateur nomme cette plate-forme et veut...	Actions courantes qu'il couvre	Notice avant d'agir
Aerodrome	Échanger, fournir de la liquidité, faire du staking, ou réclamer des récompenses sur Aerodrome.	Découverte de pool, échanges, ajout/suppression LP, staking, unstaking, réclamations de récompenses.	Base uniquement. Nécessite un harnais capable de shell pour Sugar CLI ; arrêtez-vous sur les surfaces chat uniquement.
Avantis	Négocier des contrats à terme perpétuels avec effet de levier ou inspecter l'activité commerciale Avantis.	Ouverture/fermeture de positions, annulation de commandes, ajustement de marge, définition TP/SL, affichage des positions, historique et PnL.	Base uniquement. L'effet de levier peut liquider la position ; les surfaces chat uniquement peuvent lire les données mais utilisent l'interface utilisateur Avantis pour les actions commerciales.
Balancer	Échanger des tokens ou fournir de la liquidité sur Balancer.	Lectures de pools/devis, construction de calldata swap, ajout/suppression de liquidité, soumission via `send_calls`.	CLI uniquement — nécessite l'accès au shell ; arrêtez-vous sur les surfaces chat uniquement. Multi-chaîne (Base, Ethereum, Arbitrum, Optimism, Avalanche) ; confirmez le slippage et le risque de basse liquidité.
Bankr	Découvrir des lancements de tokens frais ou acheter un token nouvellement lancé sur Bankr.	Lecture des flux de lancement, inspection des métadonnées de tokens, achat d'un token sélectionné.	Base uniquement. Les nouveaux tokens peuvent être illiquides ou dangereux ; ne les achetez pas automatiquement, et rendez explicite le risque de prix/liquidité.
Bitrefill	Acheter des cartes cadeaux, des recharges mobiles, ou des eSIM de voyage sur Bitrefill, payés avec USDC.	Recherche 1 500+ marques, paiement, livraison des codes de cartes cadeaux et détails eSIM en chat.	Base uniquement. Nécessite une connexion SIWE ; les achats sont irréversibles et gèrent des données personnelles — confirmez les détails de la commande avant de payer.
Brickken	Gérer l'identité, la réputation, ou les opérations de token agent ERC-8004 sur Brickken.	Lectures/écritures d'identité et réputation, opérations de token agent via approbation x402.	Base et Base Sepolia. Les écritures sont irréversibles et peuvent impliquer des données personnelles ; examinez avant d'approuver.
Clawnch	Découvrir des lancements de tokens récents/populaires ou lancer un token sur Clawnch.	Navigation dans les flux de lancement, inspection des tokens, lancement non-dépositaire, échange via `send_calls`.	Base uniquement. Les nouveaux tokens peuvent être illiquides ou dangereux et les lancements sont irréversibles ; rendez le risque explicite.
Flaunch	Lancer un token sur Flaunch ou découvrir/échanger des tokens Flaunch déployés.	Préparation des lancements via `mcp.flaunch.gg`, découverte de tokens, échange, soumission via `send_calls`.	Base uniquement. Les nouveaux tokens peuvent être illiquides ; les lancements et échanges sont irréversibles — confirmez d'abord les détails.
GMGN	Obtenir des devis d'échange de tokens, des prix de gas, ou de la veille commerciale sur tokens tendance sur Base via GMGN.	Devis d'échange (calldata non signé via `send_calls`), niveaux de prix du gas, tokens tendance.	Base uniquement. CLI uniquement — nécessite le shell pour générer les paramètres d'authentification ; authentification par clé API. Confirmez le slippage et surveillez les tokens à basse liquidité.
Hydrex	Échanger des tokens ou gérer des positions de liquidité concentrée sur Hydrex.	Devis, échanges, ajout/suppression de liquidité concentrée, soumission via `send_calls`.	Base uniquement. Les devis peuvent bouger ; confirmez le slippage avant les écritures.
KyberSwap	Échanger des tokens sur KyberSwap (routage du meilleur taux agrégé sur plusieurs chaînes).	Routage du meilleur taux via 50+ sources de liquidité, devis, échanges via `send_calls`.	Multi-chaîne (Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche) ; les devis peuvent bouger, confirmez le slippage avant d'échanger.
Moonwell	Prêter, emprunter, rembourser, retirer, ou vérifier les positions/récompenses Moonwell.	Lectures de marché/taux, vérifications de santé, offre, retrait, emprunt, remboursement, recherche de récompenses.	Fonctionne sur Base et Optimism. L'emprunt peut être liquidé ; affichez le facteur de santé avant les actions risquées.
Morpho	Gagner du rendement, utiliser les coffres Morpho, ou emprunter/prêter dans les marchés Morpho.	Comparaison de coffres, dépôt ou retrait, fourniture de garantie, emprunt, remboursement, vérification des positions.	Base uniquement. L'emprunt peut être liquidé ; lisez les données de santé/position avant de préparer les écritures.
o1.exchange	Échanger des tokens sur o1.exchange, éventuellement avec approbations Permit2 sans gas et routage protégé contre MEV.	Devis, échanges standard via `send_calls`, échanges Permit2 via relais privé.	Multi-chaîne (Base, BSC). Les devis peuvent bouger et les échanges sont irréversibles ; confirmez le slippage et surveillez les tokens à basse liquidité.
OpenSea	Négocier des NFT, échanger des tokens, ou minter des drops sur OpenSea.	Achat/vente/liste NFT, échanges de tokens, drops/minting, soumission via `send_calls`.	Multi-chaîne (Ethereum, Base, Polygon, Arbitrum, Optimism, Avalanche). Nécessite une clé API ; les négociations sont irréversibles — confirmez d'abord le token, le prix et le slippage.
Printr	Lancer un token multi-chaîne sur Printr.	Préparation de calldata de création de token via API HTTP, soumission via `send_calls`.	Multi-chaîne (Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, Ethereum). Les nouveaux tokens peuvent être illiquides ; les lancements sont irréversibles.
Uniswap	Échanger des tokens ou gérer les positions de liquidité Uniswap.	Échanges de tokens, vérifications d'approbation, flux de création/augmentation/diminution/collecte LP V2/V3/V4.	Base uniquement. Les devis peuvent bouger ; confirmez le slippage et les détails du token/position avant les écritures.
Venice	Exécuter une inférence IA privée ou une génération de médias sur Venice, optionnellement financées avec x402.	Inférence texte et médias via l'API Venice, financement optionnel du portefeuille x402 Base.	Base uniquement. Nécessite une connexion SIWE ; l'inférence gère des données personnelles et les appels payants sont irréversibles.
Virtuals	Créer ou exploiter des agents IA Virtuals, des cartes de paiement, ou des e-mails d'agent.	Gestion d'agents, configuration de cartes et limites, actions de boîte de réception/thread d'e-mail, connexion SIWE.	Nécessite le Virtuals MCP et une connexion signée. Gère les données personnelles ; évitez d'exposer inutilement les tokens, OTP, détails de carte ou contenus d'e-mail.
YO	Afficher les coffres YO, vérifier les positions, déposer, ou demander un retrait sur les coffres de rendement YO.	Lectures de coffres ERC-4626 via `chain_rpc_request`, dépôt, demande de retrait via `send_calls`.	Multi-chaîne (Base, Ethereum, Arbitrum). Les dépôts et retraits sont irréversibles ; confirmez les montants et le coffre avant les écritures.

Chargez une référence de plugin uniquement une fois que l'utilisateur a nommé la plate-forme qu'il couvre (selon la règle de routage ci-dessus), en suivant la même règle locale-d'abord, web-fallback que les références (voir Chargement des fichiers référencés ci-dessus). Pour les propres outils externes d'un plugin, déférez au fichier du plugin d'abord, puis à toute aide CLI, schéma API, ou descriptions d'outils MCP qu'il vous dit explicitement d'utiliser.

Plugins natifs vs. plugins personnalisés / fournis par l'utilisateur

Les hôtes HTTP de plugins natifs peuvent être autorisés dans l'outil web_request de Wallet MCP. Aerodrome, Balancer, et GMGN sont CLI uniquement et nécessitent un harnais avec accès au shell. Avantis est hybride : les lectures en lecture seule (données de marché, positions, PnL) fonctionnent sur chaque surface via web_request, tandis que les appels du constructeur tx nécessitent un harnais CLI — sur les surfaces chat uniquement, le plugin dirige l'utilisateur vers l'interface web Avantis à la place (voir plugins/avantis.md). Morpho est hybride aussi : utilisez Morpho CLI quand l'accès au shell existe, sinon utilisez ou installez le Morpho MCP comme décrit dans plugins/morpho.md. Les plugins personnalisés ou fournis par l'utilisateur ne sont généralement pas autorisés — chargez references/custom-plugins.md pour l'arbre de décision sur quel chemin HTTP utiliser (outil HTTP de harnais vs. fallback collé utilisateur, et la contrainte GET uniquement sur les surfaces consommateurs Claude/ChatGPT).

Installation

npx skills add base/skills --skill wallet-mcp