MetaMask Embedded Wallets (Web3Auth) MCP

io.github.Web3Auth由 GitHub 帳號 Web3Auth 發布v2.0.0更新於 Oct 24, 2026

Helps AI coding agents integrate MetaMask Embedded Wallets (Web3Auth) SDKs.

發布方自己的服務:Web3TV MCP Server

已驗證Streamable HTTP可網頁執行知識與記憶開發者工具

概覽

AI 產生的概覽

一個遠端 MCP 伺服器,讓 AI 程式設計助理即時取得 MetaMask Embedded Wallets(Web3Auth)文件、範例、SDK 原始碼與社群論壇內容。

可以做什麼
搜尋文件與範例專案,回傳附摘要的頁面連結與相符範例。依 URL 取得文件頁面的完整內容。從 GitHub 抓取 Web3Auth 整合範例的完整原始碼。查詢開源儲存庫中的 SDK 原始碼,例如型別、介面與 hooks。搜尋或取得 MetaMask Embedded Wallets 社群論壇的貼文。
適用情境
適合在開發或排查 MetaMask Embedded Wallets(Web3Auth)整合時使用,讓助理依據最新文件、真實範例程式碼與 SDK 型別工作,而非依賴靜態文字。README 建議搭配配套 skill 使用,以取得架構與金鑰衍生方面的指引。
執行需求
遠端 HTTP 端點 mcp.web3auth.io,不需本機執行環境;僅支援 stdio 的用戶端可透過 npx 執行 mcp-remote 橋接。需要能連線至該端點。託管部署需要 GITHUB_TOKEN,因為範例與 SDK 查詢會大量呼叫 GitHub API,未驗證的速率上限很低;選用的 DISCOURSE_API_KEY 與 DISCOURSE_API_USERNAME 可用於驗證論壇搜尋。
安裝前請注意
託管部署要求提供 GITHUB_TOKEN(個人存取權杖),應盡量縮小其權限範圍。選用的 DISCOURSE_API_KEY 與 DISCOURSE_API_USERNAME 同樣是憑證。工具本身僅做讀取查詢,但查詢內容與取得的 URL 會傳送到第三方伺服器,再由其呼叫 Algolia、GitHub 與 MetaMask 建構者論壇。README 提醒設定錯誤可能在上線環境改變錢包地址,套用產生的程式碼前應先審閱方案。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 MetaMask Embedded Wallets (Web3Auth) MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Web3Auth%2Fmcp-server/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "metamask-embedded-wallets-web3auth": {
      "type": "http",
      "url": "https://mcp.web3auth.io/"
    }
  }
}

README

MetaMask Embedded Wallets MCP Server

Build MetaMask Embedded Wallets integrations faster by giving your AI coding assistant live access to the documentation and deep knowledge of the SDK.

There are two things to set up:

  1. Skill — Teaches your AI assistant how to think about the SDK: architecture, framework quirks, key derivation rules, and common mistakes. No code in the skill; the MCP provides that.
  2. MCP server — Gives your AI assistant real-time access to search docs, fetch examples, and look up SDK types.

MCP Tools

ToolWhat it does
search_docsSearch documentation and example projects
get_docFetch the full content of any doc page
get_exampleFetch complete source code of an integration example
get_sdk_referenceFetch SDK types and hooks from the open-source repos
search_communitySearch the MetaMask Builder Hub for real user issues

Skill

The skill teaches your AI assistant the mental model for MetaMask Embedded Wallets. It includes SDK selection logic, key derivation rules, authentication concepts, platform quirks, and common mistakes that aren't obvious from the docs alone.

Tip: For the best experience, use the MCP server alongside the skill so that your LLM can fetch live docs and examples rather than relying on static text.

Universal install (works with 40+ agents)

bash
npx skills add web3auth/skill

The skills CLI by Vercel detects your active AI agent and installs to the right directory automatically — Cursor, Claude Code, Copilot, Kiro, Cline, Codex, Antigravity, and 40+ more.

To install for target a specific agent:

bash
npx skills add web3auth/skill -a cursor     # Cursor onlynpx skills add web3auth/skill -a claude-code # Claude Code only

MCP Server Setup

Cursor

The fastest way is one click:

[Add MetaMask Embedded Wallets MCP to Cursor]

Or install via Cursor Marketplace — search "MetaMask Embedded Wallets".

Or add it manually. Open Cursor Settings → Tools & Integrations → MCP and add:

json
{  "mcpServers": {    "web3auth": {      "url": "https://mcp.web3auth.io"    }  }}

VS Code (GitHub Copilot)

Install from the Visual Studio Marketplace — search "MetaMask Embedded Wallets", or:

bash
code --install-extension Web3Auth.metamask-embedded-wallets

Or use the one-click install URL:

vscode:mcp/install?{"name":"web3auth","url":"https://mcp.web3auth.io"}

Or add manually to your workspace .vscode/mcp.json:

json
{  "servers": {    "web3auth": {      "type": "http",      "url": "https://mcp.web3auth.io"    }  }}

JetBrains (IntelliJ, PyCharm, WebStorm, Android Studio)

Install from the JetBrains Marketplace — search "MetaMask Embedded Wallets".

Or add manually in Settings → Tools → AI Assistant → Model Context Protocol (MCP):

json
{  "mcpServers": {    "web3auth": {      "url": "https://mcp.web3auth.io",      "transport": "http"    }  }}

Claude Code CLI

bash
claude mcp add --transport http web3auth https://mcp.web3auth.io

Or add manually to your project's claude.json:

json
{  "mcpServers": {    "web3auth": {      "url": "https://mcp.web3auth.io"    }  }}

Claude Desktop

Open your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the server to the mcpServers section:

json
{  "mcpServers": {    "web3auth": {      "url": "https://mcp.web3auth.io"    }  }}

Restart Claude Desktop and ask: "Search MetaMask Embedded Wallets docs for React quick start" to verify the connection.

ChatGPT Desktop

Open ChatGPT Desktop → Settings → Connections and add a new MCP server:

  • Name: web3auth
  • URL: https://mcp.web3auth.io

Windsurf

Open Windsurf Settings → MCP and add:

json
{  "mcpServers": {    "web3auth": {      "serverUrl": "https://mcp.web3auth.io"    }  }}

Or edit ~/.codeium/windsurf/mcp_config.json directly.

Kiro (AWS)

Add to your project's .kiro/settings/mcp.json:

json
{  "mcpServers": {    "web3auth": {      "url": "https://mcp.web3auth.io"    }  }}

Warp Terminal

In Warp, open Settings → AI → MCP Servers and click Add Server:

  • Name: web3auth
  • URL: https://mcp.web3auth.io

Or use Warp's one-click MCP install if available in your version.

Cline (VS Code)

Add to your Cline MCP settings (Ctrl+Shift+P → "Cline: Open MCP Settings"):

json
{  "mcpServers": {    "web3auth": {      "url": "https://mcp.web3auth.io",      "transport": "http"    }  }}

Continue.dev

Add to your Continue config.json (open with Ctrl+Shift+P → "Continue: Open config.json"):

json
{  "mcpServers": [    {      "name": "web3auth",      "url": "https://mcp.web3auth.io"    }  ]}

Zed

Add to your Zed settings.json (Cmd+, to open):

json
{  "context_servers": {    "web3auth": {      "command": {        "path": "npx",        "args": ["-y", "mcp-remote", "https://mcp.web3auth.io"]      }    }  }}

Or install via Zed Extensions — search "MetaMask Embedded Wallets".

Antigravity

Open your MCP configuration file:

  • macOS/Linux: ~/.config/antigravity/mcp.json
  • Windows: %APPDATA%\antigravity\mcp.json

Add the server to the mcpServers section:

json
{  "mcpServers": {    "web3auth": {      "url": "https://mcp.web3auth.io"    }  }}

Antigravity hot-reloads MCP config changes — no restart required.

Xcode (via GitHub Copilot)

Xcode 26.3+ supports MCP via GitHub Copilot. Add the server to your Copilot MCP config or use the VS Code extension setup above (Copilot MCP registry is shared).

Alternatively, configure Xcode's agentic tools to point at https://mcp.web3auth.io directly via Settings → Copilot → MCP Servers.

Eclipse (via GitHub Copilot)

Eclipse with GitHub Copilot supports MCP. Add via Eclipse → Preferences → GitHub Copilot → MCP Servers → Add Server:

  • Name: web3auth
  • URL: https://mcp.web3auth.io

Neovim (avante.nvim)

In your Lua config, add via mcphub.nvim:

lua
require("mcphub").setup({  servers = {    web3auth = {      url = "https://mcp.web3auth.io",      transport = "streamable-http",    },  },})

Or using mcp-remote for compatibility:

lua
require("avante").setup({  mcp = {    servers = {      web3auth = {        command = "npx",        args = { "-y", "mcp-remote", "https://mcp.web3auth.io" },      },    },  },})

Neovim (codecompanion.nvim)

lua
require("codecompanion").setup({  extensions = {    mcp = {      servers = {        web3auth = {          command = "npx",          args = { "-y", "mcp-remote", "https://mcp.web3auth.io" },        },      },    },  },})

Amp (Sourcegraph)

Add to your Amp MCP configuration:

json
{  "mcpServers": {    "web3auth": {      "url": "https://mcp.web3auth.io"    }  }}

Goose

Add to ~/.config/goose/config.yaml:

yaml
extensions:  - name: web3auth    type: http    url: https://mcp.web3auth.io

5ire

In 5ire Settings → MCP Servers → Add:

  • Name: web3auth
  • URL: https://mcp.web3auth.io

Aider

Aider supports MCP via the LiteLLM bridge. Add to your Aider config:

yaml
mcp_servers:  web3auth:    command: npx    args: ["-y", "mcp-remote", "https://mcp.web3auth.io"]

Codex CLI

For Codex CLI or any stdio-only agent, use mcp-remote to bridge the HTTP endpoint:

bash
npm install -g mcp-remote

Then add to ~/.codex/config.toml:

toml
[mcp_servers.web3auth]command = "npx"args = ["-y", "mcp-remote", "https://mcp.web3auth.io"]

Or add to your agent's JSON config:

json
{  "mcpServers": {    "web3auth": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://mcp.web3auth.io"]    }  }}

Static docs (llms.txt)

If your AI tool doesn't support MCP yet, use the static documentation file instead:

https://docs.metamask.io/llms-full.txt

For tools that support the llms.txt spec and can index docs automatically:

https://docs.metamask.io/llms.txt

Warning: The static file is a snapshot and may not include the latest updates. Use the MCP server when possible for always-current docs.


Start building

Once the skill and MCP are set up, ask your AI assistant directly. Good starting prompts:

  • "Add MetaMask Embedded Wallets to my React app with Google login."
  • "Set up social login wallets in my Next.js app using Wagmi."
  • "Integrate embedded wallets in my Flutter app."
  • "Why are my users getting different wallet addresses after I changed the login method?"

Tip: Use planning mode (where available) for your initial prompt. Review the plan before generating code — this catches architecture mistakes early and avoids config errors that would change wallet addresses in production.


Distribution

This repo ships artifacts for every major developer platform:

PlatformTypeLocation
Cursor MarketplacePlugin.cursor-plugin/ + mcp.json
VS Code MarketplaceExtensionplugins/vscode/
JetBrains MarketplacePluginplugins/jetbrains/
Zed ExtensionsExtensionplugins/zed/
Claude Agent SDKPluginplugins/claude/
Raycast StoreExtensionplugins/raycast/
ChatGPT GPT StoreCustom GPTopenai/
Official MCP Registryserver.jsonserver.json
Glamaglama.jsonglama.json
SmitheryServer cardapp/.well-known/mcp/server-card.json/route.ts
Vercel skills.shSkillWeb3Auth/skill
agentskill.shSkillWeb3Auth/skill

Environment Variables

VariableRequiredDescription
GITHUB_TOKENYes (hosted) / recommended (local)GitHub personal access token. Required on the Vercel deployment (mcp.web3auth.io) — get_example and get_sdk_reference call the GitHub API heavily; without a token the shared IP hits the 60 req/hr unauthenticated limit quickly. Optional for local stdio use.
DISCOURSE_API_KEYNoDiscourse API key for search_community (optional; public search works without it)
DISCOURSE_API_USERNAMENoDiscourse API username when using DISCOURSE_API_KEY

Development

bash
npm installnpm run buildnpm test           # Handler smoke tests (mocked fetch)npm start          # Run via stdionpm run dev        # Watch mode

Updating Content

What changedWhere to update
SDK architecture, platform quirks, key derivation, workflowWeb3Auth/skill (SKILL.md)
New example repository or scan root (e.g. new platform)src/content/example-catalog.ts
New SDK repository or discovery rules (e.g. new platform)src/content/sdk-catalog.ts
New tool or parameter changessrc/tools/register.ts
Example folders / SDK file layout within existing reposNothing (discovered live from GitHub, cached 4h)
Doc page contentNothing (fetched live via Algolia / llms.txt / GitHub)

License

MIT

來源:README.md,提交 58eec17

工具

5

search_docs

Search MetaMask Embedded Wallets documentation (Algolia) and example projects. Returns doc page links with snippets and matching examples.

輸入參數chainquery必填categoryplatform

get_doc

Fetch the full content of a MetaMask Embedded Wallets documentation page by URL. Sources: Algolia, llms.txt, GitHub MDX.

輸入參數url必填

get_example

Fetch complete source code of a Web3Auth integration example from GitHub.

輸入參數namechaincategoryplatformauth_method

get_sdk_reference

Fetch SDK source code (types, interfaces, hooks) from open-source Web3Auth repos.

輸入參數focusmoduleplatform必填

search_community

Search or fetch posts from the MetaMask Embedded Wallets community forum (builder.metamask.io).

輸入參數querytopic_id

版本歷史

1
  1. v2.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Web3 整合