Agent skill

Base MCP

by base in base/skills

Base MCP — gives your AI assistant access to a Base Account via the Base MCP server (wallet-mcp.coinbase.com).

MITAuto-check passedAgent Workflows

Install Base MCP

skills CLI
$ npx skills add base/skills --skill base-mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install base/skills base-mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/base/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/base-mcp .claude/skills/base-mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
base-mcp
GitHub stars
121
Token cost
~3.5k tokens
SKILL.md length
1,765 words
Files
29 (incl. references)
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Base MCP — gives your AI assistant access to a Base Account via the Base MCP server (wallet-mcp.coinbase.com).

  • Works in 3 steps: Briefly mention what's available — one… → Show this disclaimer verbatim before… → Wallet address and balance are optional…
  • Tasks that involve MCP servers
  • SKILL.md covers Detection, Onboarding, Tools and Plugins, plus 1 more section
  • Calls npx; reaches docs.cdp.coinbase.com

What it does

Base MCP is an agent skill from base/skills. Base MCP — gives your AI assistant access to a Base Account via the Base MCP server (wallet-mcp.coinbase.com). Wallet, portfolio, sending, swapping, signing, x402 payments, batched contract calls, and transaction history across supported chains.

Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 29 other files, including reference files (for example `README.md`, `plugins/aerodrome.md` and `plugins/avantis.md`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol, x402 and Coinbase. The repository describes itself as: npx skills add base/skills. The licence is MIT.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/base-mcp”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  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…
  2. Show this disclaimer verbatim before proceeding
  3. Wallet address and balance are optional — only fetch and display them when the user asks, or when a pending operation actually needs the…

What it can do on your machine

Read from SKILL.md and the folder at commit 4f3d8f3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • docs.cdp.coinbase.com

    Also links to:

    • wallet.coinbase.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Base MCP loads about 3.5k tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 1,765 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~3.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~16k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from base/skills at commit 4f3d8f3, republished under its MIT licence (© base). 1,765 words, ~3,450 tokens.

Download SKILL.mdSave it as .claude/skills/base-mcp/SKILL.md (or your agent's skills folder). This skill also uses 28 other files; get the full folder from GitHub.
name
base-mcp
description
Base MCP — gives your AI assistant access to a Base Account via the Base MCP server (wallet-mcp.coinbase.com). Wallet, portfolio, sending, swapping, signing, x402 payments, batched contract calls, and transaction history across supported chains.
title
Base MCP Skill
version
0.1.0

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.

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.cdp.coinbase.com/ai-agents/coinbase-for-agents/wallet-mcp#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.cdp.coinbase.com/coinbase-for-agents/wallet-mcp/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).

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 third-party 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. Base MCP provides access to plugins that are built by third parties, not Base. Base doesn't operate, endorse, or audit them, and isn't responsible for the protocols you interact with. Transactions are irreversible — always review before approving.

  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.

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 allowlistreferences/custom-plugins.md
Platform install stepsreferences/install.md
Tone and language rulesreferences/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.cdp.coinbase.com/coinbase-for-agents/wallet-mcp/<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.

Plugins

Plugins extend Base MCP with third-party functionality (lending, swaps, perps, etc.). Each plugin is a separate third-party service that Base does not operate, endorse, or audit. 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.

Routing rule — name-gated, never auto-routed

Open a plugin only when the user names that specific third-party platform (e.g. "swap on Uniswap", "lend on Moonwell", "buy a gift card on Bitrefill") or otherwise unambiguously points to it. Never infer a platform from a bare capability — choosing one third-party service over another is the user's decision, not yours.

If the user asks for a capability without naming a platform — "swap some USDC", "earn yield", "launch a token", "buy a gift card" — do not pick a plugin for them. Instead, list the plugins from the table below that cover that capability (and mention any native Base MCP tool that also does, e.g. the built-in swap), then let the user choose. Only after the user names a platform do you open its plugin and act.

Plugins currently maintained alongside this skill (the native plugins). Use the table two ways: (a) to route a request that already names a platform to the right plugin, and (b) to assemble the option list when the user asks for a capability without naming one. The "Open it when…" column intentionally anchors each trigger to the platform's own name — that name is the trigger.

PluginOpen it when the user names this platform and wants to...Common actions it coversNotice before acting
AerodromeSwap, provide liquidity, stake, or claim rewards on Aerodrome.Pool discovery, swaps, LP add/remove, staking, unstaking, reward claims.Base only. Requires a shell-capable harness for the Sugar CLI; stop on chat-only surfaces.
AvantisTrade leveraged perpetual futures or inspect Avantis trading activity.Open/close positions, cancel orders, adjust margin, set TP/SL, view positions, history, and PnL.Base only. Leverage can liquidate the position; chat-only surfaces can read data but use the Avantis UI for trade actions.
BalancerSwap tokens or provide liquidity on Balancer.Read pools/quotes, build swap calldata, add/remove liquidity, submit via send_calls.CLI-only — requires shell access; stop on chat-only surfaces. Multi-chain (Base, Ethereum, Arbitrum, Optimism, Avalanche); confirm slippage and low-liquidity risk.
BankrDiscover fresh token launches or buy a newly launched token on Bankr.Read launch feeds, inspect token metadata, buy a selected token.Base only. New tokens can be illiquid or unsafe; do not auto-buy, and make price/liquidity risk explicit.
BitrefillBuy gift cards, mobile top-ups, or travel eSIMs on Bitrefill, paid with USDC.Search 1,500+ brands, check out, deliver gift-card codes and eSIM details in chat.Base only. Requires SIWE login; purchases are irreversible and handle personal data — confirm order details before paying.
BrickkenManage ERC-8004 agent identity, reputation, or agent-token operations on Brickken.Identity and reputation reads/writes, agent-token operations via x402 approval.Base and Base Sepolia. Writes are irreversible and may involve personal data; review before approving.
ClawnchDiscover recent/top token launches or launch a token on Clawnch.Browse launch feeds, inspect tokens, non-custodial launch, swap via send_calls.Base only. New tokens can be illiquid or unsafe and launches are irreversible; make risk explicit.
FlaunchLaunch a token on Flaunch or discover/swap deployed Flaunch tokens.Prepare launches via mcp.flaunch.gg, discover tokens, swap, submit via send_calls.Base only. New tokens can be illiquid; launches and swaps are irreversible — confirm details first.
GMGNGet token swap quotes, gas prices, or trending-token market intelligence on Base via GMGN.Swap quotes (unsigned calldata via send_calls), gas-price tiers, trending tokens.Base only. CLI-only — requires shell to generate auth params; API key auth. Confirm slippage and watch low-liquidity tokens.
HydrexSwap tokens or manage concentrated-liquidity positions on Hydrex.Quotes, swaps, concentrated-liquidity add/remove, submit via send_calls.Base only. Quotes can move; confirm slippage before writes.
KyberSwapSwap tokens on KyberSwap (aggregated best-rate routing across chains).Best-rate routing through 50+ liquidity sources, quotes, swaps via send_calls.Multi-chain (Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche); quotes can move, confirm slippage before swapping.
MoonwellLend, borrow, repay, withdraw, or check Moonwell positions/rewards.Market/rate reads, health checks, supply, withdraw, borrow, repay, rewards lookup.Works on Base and Optimism. Borrowing can be liquidated; surface health factor before risky actions.
MorphoEarn yield, use Morpho vaults, or borrow/lend in Morpho markets.Compare vaults, deposit or withdraw, supply collateral, borrow, repay, check positions.Base only. Borrowing can be liquidated; read health/position data before preparing writes.
o1.exchangeSwap tokens on o1.exchange, optionally with Permit2 gasless approvals and MEV-protected routing.Quotes, standard swaps via send_calls, Permit2 swaps via private relay.Multi-chain (Base, BSC). Quotes can move and swaps are irreversible; confirm slippage and watch for low-liquidity tokens.
OpenSeaTrade NFTs, swap tokens, or mint drops on OpenSea.NFT buy/sell/list, token swaps, drops/minting, submit via send_calls.Multi-chain (Ethereum, Base, Polygon, Arbitrum, Optimism, Avalanche). Requires an API key; trades are irreversible — confirm token, price, and slippage first.
PrintrLaunch a cross-chain token on Printr.Prepare token-creation calldata via HTTP API, submit via send_calls.Multi-chain (Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, Ethereum). New tokens can be illiquid; launches are irreversible.
UniswapSwap tokens or manage Uniswap liquidity positions.Token swaps, approval checks, V2/V3/V4 LP create/increase/decrease/collect flows.Base only. Quotes can move; confirm slippage and token/position details before writes.
VeniceRun private AI inference or media generation on Venice, optionally funded with x402.Text and media inference via the Venice API, optional Base x402 wallet funding.Base only. Requires SIWE login; inference handles personal data and paid calls are irreversible.
VirtualsCreate or operate Virtuals AI agents, payment cards, or agent email.Agent management, card setup and limits, email inbox/thread actions, SIWE login.Requires the Virtuals MCP and a signed login. Handles personal data; avoid exposing tokens, OTPs, card details, or email contents unnecessarily.
YOView YO vaults, check positions, deposit, or request redeem on YO yield vaults.ERC-4626 vault reads via chain_rpc_request, deposit, request redeem via send_calls.Multi-chain (Base, Ethereum, Arbitrum). Deposits and redeems are irreversible; confirm amounts and vault before writes.
Show full SKILL.md (187 more words)Show less

Load a plugin reference only once the user has named the platform it covers (per the routing rule above), 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.

Native plugins vs. custom / user-supplied plugins

Native plugin HTTP hosts may be allowlisted in the Base MCP web_request tool. Aerodrome, Balancer, and GMGN are CLI-only and require 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).

Installation

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

© base, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 28 other files (references) in skills/base-mcp of base/skills.

  • SKILL.md
  • README.md
  • plugins/aerodrome.md
  • plugins/avantis.md
  • plugins/balancer.md
  • plugins/bankr.md
  • plugins/bitrefill.md
  • plugins/brickken.md
  • plugins/clawnch.md
  • plugins/flaunch.md
  • plugins/gmgn.md
  • plugins/hydrex.md
  • plugins/kyberswap.md
  • plugins/moonwell.md
  • plugins/morpho.md
  • plugins/o1-exchange.md
  • plugins/opensea.md
  • plugins/printr.md
  • plugins/uniswap.md
  • plugins/venice.md
  • … and 9 more

Open the folder on GitHubat commit 4f3d8f3

Compare with similar skills

Base MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Base MCP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Base MCP this skillbase/skills121—~3.5kAutomated safety check: PassMIT
Toolsaustintgriffith/ethskills294—~1.6kAutomated safety check: PassNone
X402 Express Wrappermajiayu000/claude-skill-registry6662 repos~765Automated safety check: NotesMIT
Base MCP Wallet Readeraeonfun/aeon767—~2.5kAutomated safety check: PassMIT
Cds Docscoinbase/cds506—~1.1kAutomated safety check: PassApache-2.0
Finance District MCPaeonfun/aeon767—~1.1kAutomated safety check: PassMIT

Similar skills

  • Tools

    austintgriffith/ethskills

    Current Ethereum development tools, frameworks, libraries, RPCs, and block explorers.

    294 GitHub stars~1.6k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • X402 Express Wrapper

    majiayu000/claude-skill-registry

    Wrapper oficial de M2MCent (Node.js) para inyectar muros de pago x402 en APIs o servidores Model Context Protocol (MCP).

    666 GitHub starsUsed in 2 repos~765 tokens
    Agent WorkflowsAuto-check: notes
  • Reads a Base Account's address, portfolio and transaction history through the Base MCP server, and stays strictly read-only in unattended Aeon runs, reporting only changes.

    767 GitHub stars~2.5k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Cds Docs

    coinbase/cds

    Retrieve Coinbase Design System (CDS) documentation: setup, installation, theming, tokens, and per-component APIs/examples.

    506 GitHub stars~1.1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Multichain non-custodial agent wallet via Finance District - check balances, prices, and best DeFi yields, move funds, swap, and make x402 paid API calls across EVM, Solana, Bitcoin, and Sui.

    767 GitHub stars~1.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Amazon Bedrock

    aws/agent-toolkit-for-aws

    Official

    Builds generative AI applications on Amazon Bedrock. An agent skill from aws/agent-toolkit-for-aws.

    2.8k GitHub stars~8.6k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from base/skills

  • Vibenet

    base/skills

    Build on vibenet — Base's devnet for native account abstraction (EIP-8130), payer gas sponsorship (ERC-8168), and Cobalt 200ms native blocks.

    121 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed
  • Build On Base

    base/skills

    Complete Base development playbook. An agent skill from base/skills.

    121 GitHub stars~804 tokensUpdated 6 days ago
    Auto-check passed
  • Plugin Review

    base/skills

    Validate and review Base MCP plugin files against the Plugin Specification.

    121 GitHub stars~1.3k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Base MCP

What does Base MCP do?

Base MCP — gives your AI assistant access to a Base Account via the Base MCP server (wallet-mcp.coinbase.com). Base MCP is an agent skill from base/skills.com).

When should I use Base MCP?

Base MCP fits situations like: tasks that involve MCP servers.

How do I install Base MCP in Claude Code?

Run `npx skills add base/skills --skill base-mcp -a claude-code`. Or copy the skill folder (skills/base-mcp in base/skills) into .claude/skills/base-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Base MCP in Codex?

Run `npx skills add base/skills --skill base-mcp -a codex`. Or copy the skill folder (skills/base-mcp in base/skills) into .agents/skills/base-mcp in your project. Codex loads it when a task matches its description.

Can I use Base MCP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add base/skills --skill base-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/base-mcp, .gemini/skills/base-mcp, .github/skills/base-mcp and .opencode/skills/base-mcp in your project.

What does Base MCP need to run?

Going by SKILL.md and its folder, Base MCP needs the command-line tools its instructions call (npx).

Does Base MCP access the network?

SKILL.md names 2 domains. In commands or code: docs.cdp.coinbase.com; the agent is likely to contact it when it follows the instructions. As links in the text: wallet.coinbase.com. This is read from the text; nothing was executed.

Is Base MCP safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Base MCP use?

Base MCP is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Base MCP use?

About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 13k tokens, read only when the agent opens those files.

What are the alternatives to Base MCP?

Skills that share tags, products or a category with Base MCP: Tools (austintgriffith/ethskills, 294 stars), X402 Express Wrapper (majiayu000/claude-skill-registry, 666 stars), Base MCP Wallet Reader (aeonfun/aeon, 767 stars) and Cds Docs (coinbase/cds, 506 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Base MCP?

base (a GitHub organization) maintains it in base/skills, which has 121 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 1, 2026.

Source: base/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.