From a974b3394b0faccd210fdb9b82d54e57c29b401d Mon Sep 17 00:00:00 2001 From: wichlene Date: Sat, 20 Jun 2026 00:01:42 +0300 Subject: [PATCH 1/2] docs: clarify EOA wallet limitations for Base MCP onboarding MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes #1558 Adds a warning block to the Base MCP overview clarifying that only native Base Smart Wallet accounts (created via email or passkey auth) are supported, and that standard EOAs — including EOAs upgraded to a Smart Wallet — cannot connect directly due to recovery-phrase and passkey configuration differences. --- docs/ai-agents/index.mdx | 46 +++++++--------------------------------- 1 file changed, 8 insertions(+), 38 deletions(-) diff --git a/docs/ai-agents/index.mdx b/docs/ai-agents/index.mdx index 1ba0a37e2..24c58b89c 100644 --- a/docs/ai-agents/index.mdx +++ b/docs/ai-agents/index.mdx @@ -8,6 +8,14 @@ import { WalletSetupDemo } from "/snippets/WalletSetupDemo.jsx" Base MCP gives your AI assistant direct access to your [Base Account](/base-account) (the smart wallet powering the Base App). Connect once and your assistant can check balances, send funds, swap tokens, sign messages, execute contract calls, and pay x402-enabled APIs across multiple networks. Every write action requires your approval. + + **Wallet compatibility:** Base MCP supports only native Base Smart Wallet accounts created through the email or passkey authentication flow. Standard Externally Owned Accounts (EOAs) cannot connect directly. + + Native Base Smart Wallets are initialized with a 13-word recovery phrase and a device passkey configuration. Standard EOAs use a 12–24 word recovery phrase and do not produce the passkey configuration Base MCP expects, which results in schema errors. + + Upgrading an existing EOA to a Smart Wallet does **not** resolve this: the account keeps its original recovery-phrase structure and will not generate the 13-word phrase or passkey configuration required to connect. + + ## Demo @@ -33,41 +41,3 @@ sequenceDiagram AI->>MCP: get_request_status(requestId) MCP-->>AI: confirmed AI-->>User: "Done — 10 USDC sent" -``` - -## What you can do - - - - Send native tokens or ERC-20 tokens to addresses, ENS names, basenames, and cb.id names. - - - Swap supported tokens on supported mainnet chains directly from your assistant. - - - Sign EIP-712 typed data and plain messages for authentication and protocol interactions. - - - Batch multiple contract interactions into a single user approval. - - - Pay for x402-enabled API requests with USDC on Base or Base Sepolia. - - - -## Get started - - - - Connect mcp.base.org to your AI assistant in under 5 minutes. - - - Step-by-step guides for sending, swapping, checking balance, and more. - - - How the Base MCP skill works and how plugins like Morpho, Moonwell, Uniswap, Avantis, Aerodrome, Virtuals, and Bankr extend it. - - - Build your own plugin that produces unsigned calldata and executes through Base MCP's send_calls. - - From cc4ef4c35b9406736b1a68181f010a2820e0258c Mon Sep 17 00:00:00 2001 From: wichlene Date: Sat, 20 Jun 2026 00:05:35 +0300 Subject: [PATCH 2/2] docs: clarify EOA wallet limitations for Base MCP onboarding --- docs/ai-agents/index.mdx | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/docs/ai-agents/index.mdx b/docs/ai-agents/index.mdx index 24c58b89c..2a1c1c283 100644 --- a/docs/ai-agents/index.mdx +++ b/docs/ai-agents/index.mdx @@ -41,3 +41,41 @@ sequenceDiagram AI->>MCP: get_request_status(requestId) MCP-->>AI: confirmed AI-->>User: "Done — 10 USDC sent" +``` + +## What you can do + + + + Send native tokens or ERC-20 tokens to addresses, ENS names, basenames, and cb.id names. + + + Swap supported tokens on supported mainnet chains directly from your assistant. + + + Sign EIP-712 typed data and plain messages for authentication and protocol interactions. + + + Batch multiple contract interactions into a single user approval. + + + Pay for x402-enabled API requests with USDC on Base or Base Sepolia. + + + +## Get started + + + + Connect mcp.base.org to your AI assistant in under 5 minutes. + + + Step-by-step guides for sending, swapping, checking balance, and more. + + + How the Base MCP skill works and how plugins like Morpho, Moonwell, Uniswap, Avantis, Aerodrome, Virtuals, and Bankr extend it. + + + Build your own plugin that produces unsigned calldata and executes through Base MCP's send_calls. + +