docs(agents): sync base-mcp skill and native plugins (#1653)

Co-authored-by: Codex <codex-noreply@coinbase.com>

Author: youssefea

docs/agents/guides/batch-calls.mdx

@@ -60,7 +60,7 @@ Repay all my Moonwell debt
 
 <CardGroup cols={2}>
   <Card title="Native plugins" icon="puzzle-piece" href="/agents/plugins/native">
-    Morpho, Moonwell, Uniswap, Avantis, Aerodrome, Virtuals, and Bankr plugin overview.
+    Overview of the native plugins that prepare calls for Base MCP.
   </Card>
   <Card title="Sign messages" icon="pen-nib" href="/agents/guides/sign-messages">
     Sign individual messages and typed data.

docs/agents/index.mdx

@@ -69,7 +69,7 @@ sequenceDiagram
     Step-by-step guides for sending, swapping, checking balance, and more.
   </Card>
   <Card title="Plugins" icon="puzzle-piece" href="/agents/plugins">
-    How the Base MCP skill works and how plugins like Morpho, Moonwell, Uniswap, Avantis, Aerodrome, Virtuals, and Bankr extend it.
+    How the Base MCP skill works and how native and custom protocol plugins extend it.
   </Card>
   <Card title="Custom plugins" icon="puzzle-piece" href="/agents/plugins/custom-plugins">
     Build your own plugin that produces unsigned calldata and executes through Base MCP's send_calls.

docs/agents/llms-full.txt

@@ -12,7 +12,7 @@
 - Sign EIP-191 personal messages and EIP-712 typed data (SIWE, permits, protocol auth)
 - Batch multiple contract calls into a single approval via `send_calls`
 - Pay for x402-enabled API requests with USDC on Base or Base Sepolia
-- Extend with protocol plugins (Morpho, Moonwell, Uniswap, Avantis, Aerodrome, Virtuals, Bankr) or your own custom plugin
+- Extend with protocol plugins (Aerodrome, Avantis, Balancer, Bankr, Bitrefill, Brickken, Clawnch, Flaunch, GMGN, Hydrex, KyberSwap, Moonwell, Morpho, o1.exchange, OpenSea, Printr, Uniswap, Venice, Virtuals, YO) or your own custom plugin
 - Append Builder Codes to transactions for onchain attribution and revenue share
 
 ## Navigation (with brief descriptions)
@@ -33,11 +33,27 @@
 - [Make x402 Payments](https://docs.base.org/agents/guides/x402-payments.md) — `initiate_x402_request` + `complete_x402_request`: pay for x402-enabled HTTPS API requests with a user-approved USDC cap
 
 ### Plugins
-- [Native Plugins](https://docs.base.org/agents/plugins/native/index.md) — Morpho, Moonwell, Uniswap, Avantis, Aerodrome, Virtuals, and Bankr plugin overview
-- [Moonwell](https://docs.base.org/agents/plugins/native/moonwell.md) — Supply, borrow, and claim on Moonwell using `web_request` + Base MCP; no extra MCP server required
+- [Native Plugins](https://docs.base.org/agents/plugins/native/index.md) — Overview of 20 native Base MCP plugins: Aerodrome, Avantis, Balancer, Bankr, Bitrefill, Brickken, Clawnch, Flaunch, GMGN, Hydrex, KyberSwap, Moonwell, Morpho, o1.exchange, OpenSea, Printr, Uniswap, Venice, Virtuals, and YO
+- [Aerodrome](https://docs.base.org/agents/plugins/native/aerodrome.md) — CLI-only swaps and basic-pool liquidity on Aerodrome via sugar-sdk and Base MCP `send_calls`
+- [Avantis](https://docs.base.org/agents/plugins/native/avantis.md) — Perpetual futures trading on Base; reads work everywhere, trade-building uses a CLI harness or Avantis UI
+- [Balancer](https://docs.base.org/agents/plugins/native/balancer.md) — CLI-only swaps and liquidity on Balancer through shell-driven API reads, SDK calldata building, and Base MCP `send_calls`
+- [Bankr](https://docs.base.org/agents/plugins/native/bankr.md) — Discover new Base token launches through Bankr and buy selected tokens with Base MCP `swap`
+- [Bitrefill](https://docs.base.org/agents/plugins/native/bitrefill.md) — Buy gift cards, mobile top-ups, and eSIMs with USDC on Base using wallet sign-in and x402 payments
+- [Brickken](https://docs.base.org/agents/plugins/native/brickken.md) — ERC-8004 identity, reputation, and agent-token operations with Brickken prepare surfaces and Base MCP x402 approval
+- [Clawnch](https://docs.base.org/agents/plugins/native/clawnch.md) — Discover Base launches, buy launched tokens, and prepare non-custodial Clawnch token launches
+- [Flaunch](https://docs.base.org/agents/plugins/native/flaunch.md) — Prepare Base token launches through Flaunch and trade deployed Flaunch tokens with Base MCP
+- [GMGN](https://docs.base.org/agents/plugins/native/gmgn.md) — CLI-only swap quotes, gas-price tiers, and trending-token intelligence on Base via GMGN
+- [Hydrex](https://docs.base.org/agents/plugins/native/hydrex.md) — Swaps and concentrated-liquidity position management on Hydrex via prepare-server calldata and Base MCP `send_calls`
+- [KyberSwap](https://docs.base.org/agents/plugins/native/kyberswap.md) — Best-rate DEX aggregation through KyberSwap routes and Base MCP `send_calls` across supported EVM chains
+- [Moonwell](https://docs.base.org/agents/plugins/native/moonwell.md) — Supply, borrow, and claim on Moonwell using `web_request` and Base MCP; no extra MCP server required
 - [Morpho](https://docs.base.org/agents/plugins/native/morpho.md) — Vaults and Morpho Blue markets via Morpho CLI when shell access exists, or Morpho MCP on chat-only surfaces; prepare unsigned transactions and execute through Base MCP
+- [o1.exchange](https://docs.base.org/agents/plugins/native/o1-exchange.md) — Token swaps on o1.exchange through HTTP order building, unsigned transaction decoding, and Base MCP `send_calls`
+- [OpenSea](https://docs.base.org/agents/plugins/native/opensea.md) — NFT marketplace trading, token swaps, drops, and minting through OpenSea API or CLI and Base MCP `send_calls`
+- [Printr](https://docs.base.org/agents/plugins/native/printr.md) — Cross-chain token launches through Printr's HTTP API and Base MCP `send_calls`
 - [Uniswap](https://docs.base.org/agents/plugins/native/uniswap.md) — Swaps and LP position management on Base via the Uniswap API; no extra MCP server required
-- [Avantis](https://docs.base.org/agents/plugins/native/avantis.md) — CLI-only perpetual futures trading on Base via Avantis tx-builder; no extra MCP server required
+- [Venice](https://docs.base.org/agents/plugins/native/venice.md) — Private AI inference through the Venice API with optional Base x402 wallet funding through Base MCP
+- [Virtuals](https://docs.base.org/agents/plugins/native/virtuals.md) — Create and operate Virtuals AI agents, payment cards, and email identities with Base MCP SIWE login
+- [YO](https://docs.base.org/agents/plugins/native/yo.md) — YO vault reads, position checks, deposits, and redeems through `chain_rpc_request` and Base MCP `send_calls`
 - [Custom Plugins](https://docs.base.org/agents/plugins/custom-plugins.md) — Author a plugin that returns unsigned calldata for Base MCP's `send_calls` to execute under one approval
 
 ## Key Concepts (excerpts)

docs/agents/llms.txt

@@ -20,9 +20,25 @@
 - [Make x402 Payments](https://docs.base.org/agents/guides/x402-payments.md) — Pay for x402-enabled API requests with USDC using Base MCP
 
 ## Plugins
-- [Native Plugins](https://docs.base.org/agents/plugins/native/index.md) — Morpho, Moonwell, Uniswap, Avantis, Aerodrome, Virtuals, and Bankr plugin overview
-- [Moonwell](https://docs.base.org/agents/plugins/native/moonwell.md) — Lending and borrowing on Moonwell via `web_request` and Base MCP (no extra MCP server)
+- [Native Plugins](https://docs.base.org/agents/plugins/native/index.md) — Overview of 20 native Base MCP plugins: Aerodrome, Avantis, Balancer, Bankr, Bitrefill, Brickken, Clawnch, Flaunch, GMGN, Hydrex, KyberSwap, Moonwell, Morpho, o1.exchange, OpenSea, Printr, Uniswap, Venice, Virtuals, and YO
+- [Aerodrome](https://docs.base.org/agents/plugins/native/aerodrome.md) — CLI-only swaps and basic-pool liquidity on Aerodrome via sugar-sdk and Base MCP `send_calls`
+- [Avantis](https://docs.base.org/agents/plugins/native/avantis.md) — Perpetual futures trading on Base; reads work everywhere, trade-building uses a CLI harness or Avantis UI
+- [Balancer](https://docs.base.org/agents/plugins/native/balancer.md) — CLI-only swaps and liquidity on Balancer through shell-driven API reads, SDK calldata building, and Base MCP `send_calls`
+- [Bankr](https://docs.base.org/agents/plugins/native/bankr.md) — Discover new Base token launches through Bankr and buy selected tokens with Base MCP `swap`
+- [Bitrefill](https://docs.base.org/agents/plugins/native/bitrefill.md) — Buy gift cards, mobile top-ups, and eSIMs with USDC on Base using wallet sign-in and x402 payments
+- [Brickken](https://docs.base.org/agents/plugins/native/brickken.md) — ERC-8004 identity, reputation, and agent-token operations with Brickken prepare surfaces and Base MCP x402 approval
+- [Clawnch](https://docs.base.org/agents/plugins/native/clawnch.md) — Discover Base launches, buy launched tokens, and prepare non-custodial Clawnch token launches
+- [Flaunch](https://docs.base.org/agents/plugins/native/flaunch.md) — Prepare Base token launches through Flaunch and trade deployed Flaunch tokens with Base MCP
+- [GMGN](https://docs.base.org/agents/plugins/native/gmgn.md) — CLI-only swap quotes, gas-price tiers, and trending-token intelligence on Base via GMGN
+- [Hydrex](https://docs.base.org/agents/plugins/native/hydrex.md) — Swaps and concentrated-liquidity position management on Hydrex via prepare-server calldata and Base MCP `send_calls`
+- [KyberSwap](https://docs.base.org/agents/plugins/native/kyberswap.md) — Best-rate DEX aggregation through KyberSwap routes and Base MCP `send_calls` across supported EVM chains
+- [Moonwell](https://docs.base.org/agents/plugins/native/moonwell.md) — Lending and borrowing on Moonwell via `web_request` and Base MCP; no extra MCP server required
 - [Morpho](https://docs.base.org/agents/plugins/native/morpho.md) — Lending and vault operations via Morpho CLI when shell access exists, or Morpho MCP on chat-only surfaces, executed through Base MCP `send_calls`
+- [o1.exchange](https://docs.base.org/agents/plugins/native/o1-exchange.md) — Token swaps on o1.exchange through HTTP order building, unsigned transaction decoding, and Base MCP `send_calls`
+- [OpenSea](https://docs.base.org/agents/plugins/native/opensea.md) — NFT marketplace trading, token swaps, drops, and minting through OpenSea API or CLI and Base MCP `send_calls`
+- [Printr](https://docs.base.org/agents/plugins/native/printr.md) — Cross-chain token launches through Printr's HTTP API and Base MCP `send_calls`
 - [Uniswap](https://docs.base.org/agents/plugins/native/uniswap.md) — Token swaps and LP position management on Base using the Uniswap API and Base MCP
-- [Avantis](https://docs.base.org/agents/plugins/native/avantis.md) — CLI-only perpetual futures trading on Base using Avantis tx-builder and Base MCP
+- [Venice](https://docs.base.org/agents/plugins/native/venice.md) — Private AI inference through the Venice API with optional Base x402 wallet funding through Base MCP
+- [Virtuals](https://docs.base.org/agents/plugins/native/virtuals.md) — Create and operate Virtuals AI agents, payment cards, and email identities with Base MCP SIWE login
+- [YO](https://docs.base.org/agents/plugins/native/yo.md) — YO vault reads, position checks, deposits, and redeems through `chain_rpc_request` and Base MCP `send_calls`
 - [Custom Plugins](https://docs.base.org/agents/plugins/custom-plugins.md) — Build your own plugin that produces unsigned calldata and executes through Base MCP's `send_calls`

docs/agents/plugins/index.mdx

@@ -32,22 +32,36 @@ The shape of the Base MCP skill:
       <Tree.File name="approval-mode.md" />
       <Tree.File name="batch-calls.md" />
       <Tree.File name="custom-plugins.md" />
+      <Tree.File name="plugin-spec.md" />
     </Tree.Folder>
     <Tree.Folder name="plugins">
-      <Tree.File name="morpho.md" />
+      <Tree.File name="aerodrome.md" />
+      <Tree.File name="avantis.md" />
+      <Tree.File name="balancer.md" />
+      <Tree.File name="bankr.md" />
+      <Tree.File name="bitrefill.md" />
+      <Tree.File name="brickken.md" />
+      <Tree.File name="clawnch.md" />
+      <Tree.File name="flaunch.md" />
+      <Tree.File name="gmgn.md" />
+      <Tree.File name="hydrex.md" />
+      <Tree.File name="kyberswap.md" />
       <Tree.File name="moonwell.md" />
+      <Tree.File name="morpho.md" />
+      <Tree.File name="o1-exchange.md" />
+      <Tree.File name="opensea.md" />
+      <Tree.File name="printr.md" />
       <Tree.File name="uniswap.md" />
-      <Tree.File name="avantis.md" />
-      <Tree.File name="aerodrome.md" />
+      <Tree.File name="venice.md" />
       <Tree.File name="virtuals.md" />
-      <Tree.File name="bankr.md" />
+      <Tree.File name="yo.md" />
     </Tree.Folder>
   </Tree.Folder>
 </Tree>
 
 `SKILL.md` itself defines the session flow, approval handling, and plugin routing. The MCP tool descriptions are the source of truth for core tool parameters; plugin specs are loaded only when a relevant task arises, such as loading `plugins/morpho.md` for a Morpho vault request.
 
-Read the canonical file at [`skills/base-mcp/SKILL.md`](https://github.com/base/skills/blob/main/skills/base-mcp/SKILL.md).
+Read the canonical file at [`skills/base-mcp/SKILL.md`](https://github.com/base/skills/blob/master/skills/base-mcp/SKILL.md).
 
 ## How plugins extend the skill
 
@@ -98,7 +112,7 @@ Base MCP passes the calldata to Base Account for user approval. The protocol nev
 
 <CardGroup cols={2}>
   <Card title="Native plugins" icon="puzzle-piece" href="/agents/plugins/native">
-    Morpho, Moonwell, Uniswap, Avantis, Aerodrome, Virtuals, and Bankr — authored by the Base team and shipped with the skill.
+    Twenty protocol plugins authored by the Base team and shipped with the skill.
   </Card>
   <Card title="Build a custom plugin" icon="code" href="/agents/plugins/custom-plugins">
     Write your own markdown spec for any protocol with an HTTP tx-builder, CLI, or MCP server.

docs/agents/plugins/native/aerodrome.mdx

@@ -38,6 +38,6 @@ The public `https://mainnet.base.org` RPC enforces a 10-call-per-batch limit and
 
 ## Reference
 
-<Card title="Full plugin spec on GitHub" icon="github" href="https://github.com/base/skills/blob/main/skills/base-mcp/plugins/aerodrome.md">
+<Card title="Full plugin spec on GitHub" icon="github" href="https://github.com/base/skills/blob/master/skills/base-mcp/plugins/aerodrome.md">
   Setup, RPC compatibility patches, calldata-bridge code, swap/LP orchestration patterns, and what works vs. what doesn't on the public RPC.
 </Card>

docs/agents/plugins/native/avantis.mdx

@@ -59,6 +59,6 @@ No additional MCP server is required. View-only Avantis APIs are reached through
 
 ## Reference
 
-<Card title="Full plugin spec on GitHub" icon="github" href="https://github.com/base/skills/blob/main/skills/base-mcp/plugins/avantis.md">
+<Card title="Full plugin spec on GitHub" icon="github" href="https://github.com/base/skills/blob/master/skills/base-mcp/plugins/avantis.md">
   Endpoint inventory, parameters, unit/scaling rules, batching guidance, chat-only UI fallback, and error handling.
 </Card>

docs/agents/plugins/native/balancer.mdx

@@ -0,0 +1,53 @@
+---
+title: "Balancer"
+description: "Swaps and liquidity on Balancer through shell-driven API reads, SDK calldata building, and Base MCP send_calls."
+keywords: ["Balancer plugin", "Base MCP Balancer", "Balancer swap", "Balancer liquidity", "Balancer SDK"]
+---
+
+Balancer is an automated market maker for token swaps and liquidity provision. The plugin reads pool data and Smart Order Router quotes from the Balancer API, builds unsigned calldata with `@balancer/sdk`, and submits the resulting calls through Base MCP `send_calls`.
+
+**Chains:** Base, Ethereum, Arbitrum, Optimism, and Avalanche.
+
+**Operations:** pool discovery, swap quotes, swap execution, add liquidity, remove liquidity, and version-aware approval batching.
+
+<Tip>
+**CLI-only plugin.** Balancer requires shell access for both reads and calldata building. It works in CLI harnesses such as Claude Code, Codex, and Cursor terminal, and does not run from chat-only surfaces.
+</Tip>
+
+## Install Balancer SDK tooling
+
+Use a working directory with Node available:
+
+```bash
+npm init -y
+npm i @balancer/sdk viem
+export RPC_URL="<a Base RPC HTTPS endpoint>"
+```
+
+The SDK simulation needs an RPC URL. The plugin spec includes the Node scripts and approval rules needed to emit Base MCP-ready calls.
+
+## Try it
+
+```text Swap
+Swap 100 USDC for WETH on Base through Balancer
+```
+
+```text Find yield
+What's the best Balancer pool for ETH yield on Base?
+```
+
+```text Add liquidity
+Add 500 USDC and 0.2 WETH to a Balancer pool on Base
+```
+
+## Pattern
+
+The assistant fetches Balancer SOR paths with the API, then runs the SDK script to produce `{ chain, protocolVersion, minAmountOut, calls }`. For v2 routes, the batch includes ERC-20 approval to the Balancer Vault plus the Vault call. For v3 routes, it includes ERC-20 approval to Permit2, Permit2 approval to the router, then the router call. Native ETH input omits approvals and carries ETH in `value`.
+
+The emitted `calls` array maps directly to Base MCP `send_calls`. The assistant reviews output, shows the approval link, and polls `get_request_status` after approval.
+
+## Reference
+
+<Card title="Full plugin spec on GitHub" icon="github" href="https://github.com/base/skills/blob/master/skills/base-mcp/plugins/balancer.md">
+  Shell setup, GraphQL queries, SDK scripts, v2/v3 approval rules, and risk handling.
+</Card>

docs/agents/plugins/native/bankr.mdx

@@ -38,6 +38,6 @@ The Bankr feed is unfiltered. Listed tokens are not vetted, audited, or endorsed
 
 ## Reference
 
-<Card title="Full plugin spec on GitHub" icon="github" href="https://github.com/base/skills/blob/main/skills/base-mcp/plugins/bankr.md">
+<Card title="Full plugin spec on GitHub" icon="github" href="https://github.com/base/skills/blob/master/skills/base-mcp/plugins/bankr.md">
   API response shape, orchestration steps, symbol-collision and adversarial-metadata safety notes for new launches.
 </Card>

docs/agents/plugins/native/bitrefill.mdx

@@ -0,0 +1,51 @@
+---
+title: "Bitrefill"
+description: "Buy gift cards, mobile top-ups, and travel eSIMs with USDC on Base through Bitrefill."
+keywords: ["Bitrefill plugin", "Base MCP Bitrefill", "gift cards USDC", "mobile top-ups", "eSIM crypto"]
+---
+
+Bitrefill turns USDC on Base into everyday digital goods inside the conversation: gift cards, mobile refills, and travel eSIMs. The default path signs in once with the user's Base wallet, searches the catalog, creates an order, pays with USDC, then returns fulfillment details in chat.
+
+**Chain:** Base mainnet.
+
+**Operations:** catalog search, product details, checkout, invoice status, x402 payment, direct USDC payment for existing-account flows, and code or eSIM delivery.
+
+<Tip>
+**Wallet sign-in and bearer credentials.** The default flow uses SIWX/SIWE with Base MCP `sign`. Redemption codes, eSIM links, JWTs, and invoice details are sensitive and should only be shown when needed.
+</Tip>
+
+## Install Bitrefill MCP for existing accounts
+
+The default agent-commerce path uses Base MCP and the Bitrefill HTTP API. Existing Bitrefill account users can also connect the Bitrefill MCP:
+
+```bash
+claude mcp add bitrefill --url https://api.bitrefill.com/mcp
+```
+
+Keep `buy-products` out of auto-approval. The plugin also supports `npx @bitrefill/cli@latest` in shell-capable harnesses.
+
+## Try it
+
+```text Gift card
+Buy me a $25 Amazon US gift card with USDC on Base
+```
+
+```text Browse
+Show me Steam gift cards available in the US
+```
+
+```text Existing account
+Use my existing Bitrefill account to buy a travel eSIM
+```
+
+## Pattern
+
+Bitrefill uses Base MCP for `web_request`, `sign`, x402 payments, and direct `send` of USDC. It does not use `send_calls`. The assistant signs the SIWX payload, uses the returned JWT for catalog and checkout calls, confirms product, denomination, and total price, then pays the Base USDC x402 requirement or direct invoice destination.
+
+After payment, the assistant polls status and returns fulfillment data carefully because codes and QR links are bearer credentials.
+
+## Reference
+
+<Card title="Full plugin spec on GitHub" icon="github" href="https://github.com/base/skills/blob/master/skills/base-mcp/plugins/bitrefill.md">
+  Path selection, SIWX headers, x402 payments, account connector setup, and fulfillment safety notes.
+</Card>