Back to Details

base-mcp

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Base MCP

Base MCP

[!IMPORTANT]

Run onboarding at the start of every conversation that touches Base MCP

Including conversations that jump straight to a plugin topic. Onboarding is short — see below.
[!IMPORTANT]

在每一次涉及Base MCP的对话开始时，先执行引导流程

包括直接进入插件主题的对话。引导流程很短——详见下文。

Detection

检测

The Base MCP exposes its tools to the harness when connected. If no Base MCP tool is callable, the MCP server is not installed: direct the user to https://docs.base.org/ai-agents/quickstart (or load references/install.md for app-specific steps) and stop.
If Base MCP tools are available, load references/tone.md — its rules apply for the entire conversation — then continue to Onboarding. If — and only if — sibling files aren't readable (e.g. you were handed just this 
SKILL.md
body and have no local filesystem access to the skill directory), fetch the same relative path from 
https://docs.base.org/ai-agents/skills/references/tone.md
using the 
web_request
tool from Base MCP. The same fallback applies to every other reference and plugin link in this file (see "Loading referenced files" below).
当连接成功后，Base MCP会向工具框架暴露其工具。如果无法调用任何Base MCP工具，则说明未安装MCP服务器：引导用户访问https://docs.base.org/ai-agents/quickstart（或加载[references/install.md](references/install.md)获取针对特定应用的安装步骤），然后停止操作。
如果Base MCP工具可用，请加载references/tone.md — 其中的规则适用于整个对话 — 然后继续执行引导流程。如果（且仅当）无法读取同级文件（例如，仅提供了此
SKILL.md
内容，无法访问技能目录的本地文件系统），请使用Base MCP提供的
web_request
工具，从
https://docs.base.org/ai-agents/skills/references/tone.md
获取相同相对路径的文件。此回退机制适用于本文档中的所有其他参考资料和插件链接（详见下文“加载参考文件”）。

Onboarding

引导流程

Keep it short. Do this once per session, before doing real work:
  1. Briefly mention what's available — one or two sentences. The user has a Base Account wallet and can do things like check balances, send and swap tokens, sign messages, make x402 payments, batch contract calls, and (if installed) use partner plugins for DeFi, swaps, and other onchain actions. Do not enumerate every tool — the agent discovers tools and plugins directly from the MCP.
  2. Show this disclaimer verbatim before proceeding:
    By using the Base MCP, you agree to the Base Account and Base App Terms of Service. Plugins available in the Base repo are authored by Base, not by the third-party protocols they reference.
  3. Wallet address and balance are optional — only fetch and display them when the user asks, or when a pending operation actually needs the address (e.g., a write call, a position lookup). Don't volunteer a wallet dump up front.
保持简洁。每个会话只需执行一次，在开展实际操作之前完成：
  1. 简要说明可用功能 — 一两句话即可。用户拥有Base账户钱包，可执行查看余额、转账、代币兑换、签名消息、进行x402支付、批量合约调用，以及（若已安装）使用DeFi、兑换等链上操作的合作伙伴插件。无需枚举所有工具 — 助手可直接从MCP发现工具和插件。
  2. 在继续操作前，逐字显示以下免责声明：
    使用Base MCP，即表示您同意Base账户和Base应用的服务条款。Base仓库中提供的插件由Base开发，而非其所引用的第三方协议开发。
  3. 钱包地址和余额为可选内容 — 仅当用户询问，或待执行操作确实需要地址时（例如写入调用、持仓查询），才获取并显示这些信息。不要主动展示钱包的完整信息。

Tools

工具

The Base MCP advertises its own tool catalog to the harness. Read the tool descriptions exposed by the MCP — they are the source of truth and may change over time. Do not assume a fixed list; do not preload a tool catalog from this skill.
Two patterns deserve their own references because they span multiple tools:
TopicReference
Approval flow (for any write tool that returns an approval URL)references/approval-mode.md
Batched contract calls (EIP-5792)references/batch-calls.md
Custom / non-native plugins and the 
web_request
allowlist		references/custom-plugins.md
Platform install stepsreferences/install.md
Tone and language rulesreferences/tone.md
Base MCP会向工具框架公布自身的工具目录。请阅读MCP暴露的工具描述 — 这些描述是权威来源，且可能随时间变化。不要假设工具列表固定；不要从此技能文件中预加载工具目录。
有两种模式值得单独参考，因为它们涉及多个工具：
主题参考资料
审批流程（适用于返回审批URL的所有写入工具）references/approval-mode.md
批量合约调用（EIP-5792）references/batch-calls.md
自定义/非原生插件与
web_request
白名单		references/custom-plugins.md
平台安装步骤references/install.md
语气与语言规则references/tone.md

Loading referenced files

加载参考文件

  • Default — local. Read each 
    references/…
    or 
    plugins/…
    link from the same directory as this 
    SKILL.md
    (filesystem read, e.g. 
    Read
    /
    cat
    ). This is the canonical source — always try this first.
  • Fallback — web (only when local read fails). If — and only if — the local file is genuinely unreadable (e.g. you were handed 
    SKILL.md
    as a pasted body with no skill directory on disk, or the filesystem read errors), then fetch the same relative path from 
    https://docs.base.org/ai-agents/skills/<path>
    (replace 
    <path>
    with the relative link, e.g. 
    references/tone.md
    , 
    plugins/morpho.md
    ). Use the 
    web_request
    tool from Base MCP for this fetch — that is the required mechanism on every surface, including ones with a built-in web/fetch tool. Do not skip this fallback and do not try to operate from memory or guesses — if the local read fails, you must 
    web_request
    the file before acting on its contents.
  • Lazy. Only load a reference or plugin when the conversation actually needs it. Don't preload the catalog.
  • 默认方式 — 本地读取。从与本
    SKILL.md
    相同的目录中读取每个
    references/…
    或
    plugins/…
    链接的文件（文件系统读取，例如
    Read
    /
    cat
    命令）。这是标准来源 — 请始终先尝试此方式。
  • 回退方式 — 网络读取（仅当本地读取失败时）。如果（且仅当）本地文件确实无法读取（例如，仅提供了粘贴的
    SKILL.md
    内容，磁盘上无技能目录，或文件系统读取出错），则从
    https://docs.base.org/ai-agents/skills/<path>
    获取相同相对路径的文件（将
    <path>
    替换为相对链接，例如
    references/tone.md
    、
    plugins/morpho.md
    ）。请使用Base MCP提供的
    web_request
    工具进行此获取操作 — 这是所有场景下的要求机制，包括自带网络/fetch工具的场景。不要跳过此回退机制，也不要凭记忆或猜测操作 — 如果本地读取失败，必须先通过
    web_request
    获取文件，再根据其内容执行操作。
  • 按需加载。仅当对话实际需要时，才加载参考资料或插件。不要预加载目录。

Plugins

插件

Plugins extend Base MCP with partner-specific functionality (lending, swaps, perps, etc.). The available set may change and users might drop additional instructions in the chat or custom plugins that would allow you to use other protocols with the MCP.
Plugins currently maintained alongside this skill (the native plugins):
PluginReference
Morphoplugins/morpho.md
Moonwellplugins/moonwell.md
Uniswapplugins/uniswap.md
Avantis (hybrid)plugins/avantis.md
Virtualsplugins/virtuals.md
Aerodrome (CLI-only)plugins/aerodrome.md
Bankrplugins/bankr.md
Load a plugin reference only when the user's request matches it, following the same local-first, web-fallback rule as references (see Loading referenced files above). For a plugin's own external tools, defer to the plugin file first, then to any CLI help, API schema, or MCP tool descriptions it explicitly tells you to use.
插件可为Base MCP扩展合作伙伴专属功能（借贷、兑换、永续合约等）。可用插件集可能会变化，用户可能会在聊天中添加额外指令或自定义插件，使您能够通过MCP使用其他协议。
当前与此技能一同维护的插件（原生插件）：
插件参考资料
Morphoplugins/morpho.md
Moonwellplugins/moonwell.md
Uniswapplugins/uniswap.md
Avantis（混合模式）plugins/avantis.md
Virtualsplugins/virtuals.md
Aerodrome（仅支持CLI）plugins/aerodrome.md
Bankrplugins/bankr.md
仅当用户请求匹配某插件时，才加载该插件的参考资料，遵循与参考资料相同的“本地优先、网络回退”规则（详见上文“加载参考文件”）。对于插件自身的外部工具，请优先遵循插件文件的说明，然后再使用其明确指定的CLI帮助、API schema或MCP工具描述。

Native plugins vs. custom / user-supplied plugins

原生插件 vs. 自定义/用户提供的插件

Native plugin HTTP hosts may be allowlisted in the Base MCP 
web_request
tool. Aerodrome is CLI-only and requires a harness with shell access. Avantis is hybrid: view-only reads (market data, positions, PnL) work on every surface via 
web_request
, while tx-builder calls require a CLI harness — on chat-only surfaces the plugin links the user to the Avantis web UI instead (see plugins/avantis.md). Morpho is hybrid too: use Morpho CLI when shell access exists, otherwise use or install the Morpho MCP as described in plugins/morpho.md. Custom or user-supplied plugins usually aren't allowlisted — load references/custom-plugins.md for the decision tree on which HTTP path to use (harness HTTP tool vs. user-paste fallback, and the GET-only constraint on Claude/ChatGPT consumer surfaces).
原生插件的HTTP主机可能已在Base MCP的
web_request
工具中加入白名单。Aerodrome仅支持CLI，需要具备shell访问权限的工具框架。Avantis为混合模式：仅查看类读取操作（市场数据、持仓、盈亏）可通过
web_request
在所有场景下使用，而交易构建器调用需要CLI工具框架 — 在仅支持聊天的场景中，插件会引导用户前往Avantis网页UI（详见plugins/avantis.md）。Morpho也是混合模式：若具备shell访问权限，请使用Morpho CLI，否则请按照plugins/morpho.md中的说明使用或安装Morpho MCP。自定义或用户提供的插件通常未加入白名单 — 请加载references/custom-plugins.md，根据决策树选择应使用的HTTP路径（工具框架HTTP工具 vs. 用户粘贴回退，以及Claude/ChatGPT消费级场景下仅允许GET请求的限制）。

Installation

安装

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