Base MCP

[!IMPORTANT]

Exécute l'onboarding au début de chaque conversation touchant à Base MCP

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

Détection

Le Base MCP expose ses outils au harness lors de la connexion. Si aucun outil Base MCP n'est appelable, le serveur MCP n'est pas installé : dirige l'utilisateur vers https://docs.base.org/ai-agents/quickstart (ou charge references/install.md pour les étapes spécifiques à l'app) et arrête-toi.

Si les outils Base MCP sont disponibles, charge references/tone.md — ses règles s'appliquent pour toute la conversation — puis continue vers l'Onboarding. Si — et seulement si — les fichiers adjacents ne sont pas lisibles (par ex. on t'a remis juste le corps de ce SKILL.md et tu n'as pas d'accès au système de fichiers local du répertoire skill), récupère le même chemin relatif depuis https://docs.base.org/ai-agents/skills/references/tone.md en utilisant l'outil web_request du Base MCP. Le même fallback s'applique à chaque autre référence et lien de plugin dans ce fichier (voir « Charger les fichiers référencés » ci-dessous).

Onboarding

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

1. Mentionne brièvement ce qui est disponible — une ou deux phrases. L'utilisateur a un wallet Base Account et peut faire des choses comme vérifier les soldes, envoyer et swapper des tokens, signer des messages, effectuer des paiements x402, traiter les appels de contrats par lot, et (si installé) utiliser les plugins partenaires pour DeFi, swaps et autres actions onchain. N'énumère pas chaque outil — l'agent découvre les outils et plugins directement depuis le MCP.

2. Affiche ce disclaimer verbatim avant de procéder :

   En utilisant le Base MCP, vous acceptez les Conditions d'utilisation de Base Account et Base App. Les plugins disponibles dans le repo Base sont rédigés par Base, pas par les protocoles tiers qu'ils référencent.

3. L'adresse du wallet et le solde sont optionnels — récupère et affiche-les seulement quand l'utilisateur les demande, ou quand une opération en attente a réellement besoin de l'adresse (par ex. un appel write, une recherche de position). Ne propose pas un dump de wallet d'emblée.

Outils

Le Base MCP annonce son propre catalogue d'outils au harness. Lis les descriptions d'outils exposées par le MCP — elles sont la source de vérité et peuvent changer dans le temps. Ne suppose pas une liste fixe ; ne précharge pas un catalogue d'outils depuis cette skill.

Deux patterns méritent leurs propres références car ils s'étendent sur plusieurs outils :

Charger les fichiers référencés

• Par défaut — local. Lis chaque lien references/… ou plugins/… depuis le même répertoire que ce SKILL.md (lecture du système de fichiers, par ex. Read/cat). C'est la source canonique — essaie toujours ceci en premier.
• Fallback — web (seulement quand la lecture locale échoue). Si — et seulement si — le fichier local est réellement illisible (par ex. on t'a remis SKILL.md comme un corps collé sans répertoire skill sur disque, ou la lecture du système de fichiers échoue), alors récupère le même chemin relatif depuis https://docs.base.org/ai-agents/skills/<path> (remplace <path> par le lien relatif, par ex. references/tone.md, plugins/morpho.md). Utilise l'outil web_request du Base 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 saute pas ce fallback et ne tente pas d'opérer depuis la mémoire ou des hypothèses — si la lecture locale échoue, tu dois web_request le fichier avant d'agir sur son contenu.
• Lazy. Charge une référence ou un plugin seulement quand la conversation en a réellement besoin. Ne précharge pas le catalogue.

Plugins

Les plugins étendent le Base MCP avec une fonctionnalité spécifique aux partenaires (lending, swaps, perps, etc.). L'ensemble disponible peut changer et les utilisateurs pourraient fournir des instructions supplémentaires dans le chat ou des plugins personnalisés qui t'permettraient d'utiliser d'autres protocoles avec le MCP.

Plugins actuellement maintenus aux côtés de cette skill (les plugins natifs) :

Charge une référence de plugin seulement quand la demande de l'utilisateur y correspond, en suivant la même règle local-d'abord, web-fallback que les références (voir Charger les fichiers référencés ci-dessus). Pour les outils externes du plugin lui-même, défère au fichier de plugin en premier, puis à toute aide CLI, schéma API ou description d'outil MCP qu'il t'indique explicitement d'utiliser.

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

Les hôtes HTTP de plugins natifs peuvent être en liste blanche dans l'outil web_request du Base MCP ; les plugins CLI-only (Avantis, Aerodrome) requièrent un harness avec accès shell et ne fonctionnent pas depuis les surfaces chat-seulement. Morpho est hybride : utilise Morpho CLI quand l'accès shell existe, sinon utilise ou installe 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 en liste blanche — charge references/custom-plugins.md pour l'arbre de décision sur quel chemin HTTP utiliser (outil HTTP harness vs. fallback user-paste, et la contrainte GET-only sur les surfaces consumer Claude/ChatGPT).

Installation

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