{"id":50196646,"url":"https://github.com/web3auth/web3auth-mcp","last_synced_at":"2026-05-25T18:05:29.490Z","repository":{"id":341611847,"uuid":"1161784752","full_name":"Web3Auth/web3auth-mcp","owner":"Web3Auth","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-31T14:15:58.000Z","size":13452,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T16:20:07.168Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://web3auth-mcp.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Web3Auth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-19T14:13:38.000Z","updated_at":"2026-03-31T14:16:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Web3Auth/web3auth-mcp","commit_stats":null,"previous_names":["web3auth/web3auth-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Web3Auth/web3auth-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Web3Auth%2Fweb3auth-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Web3Auth%2Fweb3auth-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Web3Auth%2Fweb3auth-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Web3Auth%2Fweb3auth-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Web3Auth","download_url":"https://codeload.github.com/Web3Auth/web3auth-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Web3Auth%2Fweb3auth-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33486823,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T14:31:05.219Z","status":"ssl_error","status_checked_at":"2026-05-25T14:31:02.878Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-25T18:05:24.218Z","updated_at":"2026-05-25T18:05:29.481Z","avatar_url":"https://github.com/Web3Auth.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MetaMask Embedded Wallets MCP Server\n\nBuild MetaMask Embedded Wallets integrations faster by giving your AI coding assistant live access to the\ndocumentation and deep knowledge of the SDK.\n\nThere are two things to set up:\n\n1. **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.\n2. **MCP server** — Gives your AI assistant real-time access to search docs, fetch examples, and look up SDK types.\n\n---\n\n## MCP Tools\n\n| Tool                | What it does                                         |\n| ------------------- | ---------------------------------------------------- |\n| `search_docs`       | Search documentation and example projects            |\n| `get_doc`           | Fetch the full content of any doc page               |\n| `get_example`       | Fetch complete source code of an integration example |\n| `get_sdk_reference` | Fetch SDK types and hooks from the open-source repos |\n| `search_community`  | Search the MetaMask Builder Hub for real user issues |\n\n---\n\n## Skill\n\nThe skill teaches your AI assistant the mental model for MetaMask Embedded Wallets. It includes SDK selection\nlogic, key derivation rules, authentication concepts, platform quirks, and common mistakes that aren't obvious\nfrom the docs alone.\n\n\u003e **Tip:** For the best experience, use the MCP server alongside the skill so that your LLM can fetch live docs\n\u003e and examples rather than relying on static text.\n\n### Universal install (works with 18+ agents)\n\n```bash\nnpx skills add Web3Auth/web3auth-mcp --skill web3auth -y\n```\n\nThe [`skills` CLI](https://skills.sh) 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](https://skills.sh).\n\nTo install globally (available in all projects) or target a specific agent:\n\n```bash\nnpx skills add Web3Auth/web3auth-mcp --skill web3auth -g -y            # global\nnpx skills add Web3Auth/web3auth-mcp --skill web3auth -a cursor -y     # Cursor only\nnpx skills add Web3Auth/web3auth-mcp --skill web3auth -a claude-code -y # Claude Code only\n```\n\n### Cursor\n\n```bash\nnpx degit Web3Auth/web3auth-mcp/skills/web3auth .cursor/skills/web3auth\n```\n\nCursor picks up any `SKILL.md` inside `.cursor/skills/` automatically and activates it when relevant.\n\nOr install via [Cursor Marketplace](https://cursor.com/marketplace) — search \"MetaMask Embedded Wallets\".\n\n### Claude Code CLI\n\n```bash\nnpx degit Web3Auth/web3auth-mcp/skills/web3auth /tmp/web3auth-skill\ncat /tmp/web3auth-skill/SKILL.md \u003e\u003e CLAUDE.md\n```\n\n### Claude Desktop\n\nOpen **Claude Desktop → Settings → Custom Instructions** and paste the contents of [`skills/web3auth/SKILL.md`](./skills/web3auth/SKILL.md) directly.\n\n### Antigravity\n\n```bash\nnpx degit Web3Auth/web3auth-mcp/skills/web3auth .agent/skills/web3auth\n```\n\nAntigravity picks up skills inside `.agent/skills/` automatically. For global installation across all\nprojects, use `~/.gemini/antigravity/skills/` instead.\n\n### Windsurf / Cline / Kiro / Continue\n\n```bash\nnpx degit Web3Auth/web3auth-mcp/skills/web3auth .windsurf/skills/web3auth\n```\n\nPlace the skill in the tool-specific skills directory. Most tools also accept pasting the contents of `SKILL.md` into a system prompt or custom instructions field.\n\n### Other tools\n\nFor any LLM tool with a system prompt or custom instructions field, paste the contents of\n[`skills/web3auth/SKILL.md`](./skills/web3auth/SKILL.md) directly.\n\n---\n\n## MCP Server Setup\n\n### Cursor\n\nThe fastest way is one click:\n\n[![Add MetaMask Embedded Wallets MCP to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=web3auth\u0026config=eyJ1cmwiOiJodHRwczovL21jcC53ZWIzYXV0aC5pbyJ9)\n\nOr install via [Cursor Marketplace](https://cursor.com/marketplace) — search \"MetaMask Embedded Wallets\".\n\nOr add it manually. Open **Cursor Settings → Tools \u0026 Integrations → MCP** and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"url\": \"https://mcp.web3auth.io\"\n    }\n  }\n}\n```\n\n### VS Code (GitHub Copilot)\n\nInstall from the Visual Studio Marketplace — search \"MetaMask Embedded Wallets\", or:\n\n```bash\ncode --install-extension Web3Auth.metamask-embedded-wallets\n```\n\nOr use the one-click install URL:\n\n```\nvscode:mcp/install?{\"name\":\"web3auth\",\"url\":\"https://mcp.web3auth.io\"}\n```\n\nOr add manually to your workspace `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"web3auth\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.web3auth.io\"\n    }\n  }\n}\n```\n\n### JetBrains (IntelliJ, PyCharm, WebStorm, Android Studio)\n\nInstall from the JetBrains Marketplace — search \"MetaMask Embedded Wallets\".\n\nOr add manually in **Settings → Tools → AI Assistant → Model Context Protocol (MCP)**:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"url\": \"https://mcp.web3auth.io\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\n### Claude Code CLI\n\n```bash\nclaude mcp add --transport http web3auth https://mcp.web3auth.io\n```\n\nOr add manually to your project's `claude.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"url\": \"https://mcp.web3auth.io\"\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nOpen your Claude Desktop configuration file:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAdd the server to the `mcpServers` section:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"url\": \"https://mcp.web3auth.io\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop and ask: _\"Search MetaMask Embedded Wallets docs for React quick start\"_ to verify the connection.\n\n### ChatGPT Desktop\n\nOpen **ChatGPT Desktop → Settings → Connections** and add a new MCP server:\n\n- **Name**: web3auth\n- **URL**: `https://mcp.web3auth.io`\n\n### Windsurf\n\nOpen **Windsurf Settings → MCP** and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"serverUrl\": \"https://mcp.web3auth.io\"\n    }\n  }\n}\n```\n\nOr edit `~/.codeium/windsurf/mcp_config.json` directly.\n\n### Kiro (AWS)\n\nAdd to your project's `.kiro/settings/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"url\": \"https://mcp.web3auth.io\"\n    }\n  }\n}\n```\n\n### Warp Terminal\n\nIn Warp, open **Settings → AI → MCP Servers** and click **Add Server**:\n\n- **Name**: web3auth\n- **URL**: `https://mcp.web3auth.io`\n\nOr use Warp's one-click MCP install if available in your version.\n\n### Cline (VS Code)\n\nAdd to your Cline MCP settings (`Ctrl+Shift+P` → \"Cline: Open MCP Settings\"):\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"url\": \"https://mcp.web3auth.io\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\n### Continue.dev\n\nAdd to your Continue `config.json` (open with `Ctrl+Shift+P` → \"Continue: Open config.json\"):\n\n```json\n{\n  \"mcpServers\": [\n    {\n      \"name\": \"web3auth\",\n      \"url\": \"https://mcp.web3auth.io\"\n    }\n  ]\n}\n```\n\n### Zed\n\nAdd to your Zed `settings.json` (`Cmd+,` to open):\n\n```json\n{\n  \"context_servers\": {\n    \"web3auth\": {\n      \"command\": {\n        \"path\": \"npx\",\n        \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.web3auth.io\"]\n      }\n    }\n  }\n}\n```\n\nOr install via Zed Extensions — search \"MetaMask Embedded Wallets\".\n\n### Antigravity\n\nOpen your MCP configuration file:\n\n- **macOS/Linux**: `~/.config/antigravity/mcp.json`\n- **Windows**: `%APPDATA%\\antigravity\\mcp.json`\n\nAdd the server to the `mcpServers` section:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"url\": \"https://mcp.web3auth.io\"\n    }\n  }\n}\n```\n\nAntigravity hot-reloads MCP config changes — no restart required.\n\n### Xcode (via GitHub Copilot)\n\nXcode 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).\n\nAlternatively, configure Xcode's agentic tools to point at `https://mcp.web3auth.io` directly via Settings → Copilot → MCP Servers.\n\n### Eclipse (via GitHub Copilot)\n\nEclipse with GitHub Copilot supports MCP. Add via **Eclipse → Preferences → GitHub Copilot → MCP Servers → Add Server**:\n\n- **Name**: web3auth\n- **URL**: `https://mcp.web3auth.io`\n\n### Neovim (avante.nvim)\n\nIn your Lua config, add via [mcphub.nvim](https://github.com/ravitemer/mcphub.nvim):\n\n```lua\nrequire(\"mcphub\").setup({\n  servers = {\n    web3auth = {\n      url = \"https://mcp.web3auth.io\",\n      transport = \"streamable-http\",\n    },\n  },\n})\n```\n\nOr using mcp-remote for compatibility:\n\n```lua\nrequire(\"avante\").setup({\n  mcp = {\n    servers = {\n      web3auth = {\n        command = \"npx\",\n        args = { \"-y\", \"mcp-remote\", \"https://mcp.web3auth.io\" },\n      },\n    },\n  },\n})\n```\n\n### Neovim (codecompanion.nvim)\n\n```lua\nrequire(\"codecompanion\").setup({\n  extensions = {\n    mcp = {\n      servers = {\n        web3auth = {\n          command = \"npx\",\n          args = { \"-y\", \"mcp-remote\", \"https://mcp.web3auth.io\" },\n        },\n      },\n    },\n  },\n})\n```\n\n### Amp (Sourcegraph)\n\nAdd to your Amp MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"url\": \"https://mcp.web3auth.io\"\n    }\n  }\n}\n```\n\n### Goose\n\nAdd to `~/.config/goose/config.yaml`:\n\n```yaml\nextensions:\n  - name: web3auth\n    type: http\n    url: https://mcp.web3auth.io\n```\n\n### 5ire\n\nIn 5ire Settings → MCP Servers → Add:\n\n- **Name**: web3auth\n- **URL**: `https://mcp.web3auth.io`\n\n### Aider\n\nAider supports MCP via the LiteLLM bridge. Add to your Aider config:\n\n```yaml\nmcp_servers:\n  web3auth:\n    command: npx\n    args: [\"-y\", \"mcp-remote\", \"https://mcp.web3auth.io\"]\n```\n\n### Codex CLI\n\nFor Codex CLI or any stdio-only agent, use [mcp-remote](https://github.com/modelcontextprotocol/mcp-remote) to bridge the HTTP endpoint:\n\n```bash\nnpm install -g mcp-remote\n```\n\nThen add to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.web3auth]\ncommand = \"npx\"\nargs = [\"-y\", \"mcp-remote\", \"https://mcp.web3auth.io\"]\n```\n\nOr add to your agent's JSON config:\n\n```json\n{\n  \"mcpServers\": {\n    \"web3auth\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.web3auth.io\"]\n    }\n  }\n}\n```\n\n---\n\n## Static docs (llms.txt)\n\nIf your AI tool doesn't support MCP yet, use the static documentation file instead:\n\n```\nhttps://docs.metamask.io/llms-full.txt\n```\n\nFor tools that support the [llms.txt spec](https://llmstxt.org/) and can index docs automatically:\n\n```\nhttps://docs.metamask.io/llms.txt\n```\n\n\u003e **Warning:** The static file is a snapshot and may not include the latest updates. Use the MCP server when possible for always-current docs.\n\n---\n\n## Start building\n\nOnce the skill and MCP are set up, ask your AI assistant directly. Good starting prompts:\n\n- _\"Add MetaMask Embedded Wallets to my React app with Google login.\"_\n- _\"Set up social login wallets in my Next.js app using Wagmi.\"_\n- _\"Integrate embedded wallets in my Flutter app.\"_\n- _\"Why are my users getting different wallet addresses after I changed the login method?\"_\n\n\u003e **Tip:** Use planning mode (where available) for your initial prompt. Review the plan before generating code — this\n\u003e catches architecture mistakes early and avoids config errors that would change wallet addresses in production.\n\n---\n\n## Distribution\n\nThis repo ships artifacts for every major developer platform:\n\n| Platform | Type | Location |\n| -------- | ---- | -------- |\n| Cursor Marketplace | Plugin | `.cursor-plugin/` + `mcp.json` |\n| VS Code Marketplace | Extension | `plugins/vscode/` |\n| JetBrains Marketplace | Plugin | `plugins/jetbrains/` |\n| Zed Extensions | Extension | `plugins/zed/` |\n| Claude Agent SDK | Plugin | `plugins/claude/` |\n| Raycast Store | Extension | `plugins/raycast/` |\n| ChatGPT GPT Store | Custom GPT | `openai/` |\n| Official MCP Registry | `server.json` | `server.json` |\n| Glama | `glama.json` | `glama.json` |\n| Smithery | Server card | `app/.well-known/mcp/server-card.json/route.ts` |\n| Vercel skills.sh | Skill | `skills/web3auth/` |\n| agentskill.sh | Skill | `skills/web3auth/` |\n\n---\n\n## Environment Variables\n\n| Variable       | Required | Description                                                                                                                  |\n| -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| `GITHUB_TOKEN` | No       | GitHub personal access token. Optional but recommended to avoid rate limits when fetching SDK source code via `get_sdk_reference` |\n\n---\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm start          # Run via stdio\nnpm run dev        # Watch mode\n```\n\n## Updating Content\n\nWhen a product update ships, only a few files need changing:\n\n| What changed                     | File to update                    |\n| -------------------------------- | --------------------------------- |\n| SDK architecture / new gotchas   | `skills/web3auth/SKILL.md`        |\n| New doc pages or URL changes     | `src/content/registry.ts`         |\n| Platform capabilities changed    | `src/content/platform-matrix.ts`  |\n| SDK repo structure changed       | `src/content/sdk-registry.ts`     |\n| New tool category needed         | `src/tools/register.ts`           |\n| Doc page content changed         | Nothing (fetched live)            |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweb3auth%2Fweb3auth-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fweb3auth%2Fweb3auth-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fweb3auth%2Fweb3auth-mcp/lists"}