Skip to main content

Build with AI

Speed up MetaMask Embedded Wallets integrations by giving your AI coding assistant access to the documentation and SDK reference information.

You'll set up the following:

  • Skill: Guides your AI assistant on how to reason about the SDK (for example, architecture, framework-specific considerations, key derivation rules, and common pitfalls). There's no code in the skill; the MCP provides that.
  • MCP server: Provides real-time access to documentation search, code examples, and SDK types.

Skill​

The Skill guides your AI assistant by providing a 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. The Skill contains no code — the MCP server provides up-to-date code examples and implementation references.

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.

Run the following in your project directory:

npx skills add web3auth/skill

The skills CLI detects your active AI agent and installs to the correct directory automatically. Works with Cursor, Claude Code, Copilot, Kiro, Cline, Codex, Antigravity, and 40+ more agents. See the web3auth/skill README for global and per-agent install options.

Manual install​

If you prefer to install the skill without the CLI, use the following per-tool instructions.

Cursor

npx skills add web3auth/skill -a cursor

Or copy the skill directly into your project:

npx degit Web3Auth/web3auth-mcp/skills/web3auth .cursor/skills/web3auth

Cursor picks up each SKILL.md under .cursor/skills/<skill-name>/ automatically and activates it when relevant.

Claude Code CLI

npx skills add web3auth/skill -a claude-code

Antigravity

npx skills add web3auth/skill -a antigravity

Or copy the skill directly into your project:

npx degit Web3Auth/web3auth-mcp/skills/web3auth .agent/skills/web3auth

Antigravity picks up skills inside .agent/skills/ automatically. For global installation across all projects, use ~/.gemini/antigravity/skills/ instead.

Claude Desktop and other tools

Open Claude Desktop → Settings → Custom Instructions (or your tool's equivalent system prompt or custom instructions field) and paste the skill content below directly.

View SKILL.md file
SKILL.md

MCP server​

The MetaMask Embedded Wallets MCP server connects your AI coding assistant directly to the documentation. It provides five 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

Cursor​

Select the following button to install the MCP server in Cursor automatically:

Add MetaMask Embedded Wallets MCP to Cursor

You can also add it manually. Open Cursor Settings → Tools & Integrations → MCP and add:

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

Claude Code CLI​

Run the following in your terminal:

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

Or add manually to your project's claude.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:

{
  "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.

Antigravity​

Open your MCP configuration file:

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

Add the server to the mcpServers section:

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

Antigravity automatically reloads MCP configuration changes. You don't need to restart it.

Codex CLI​

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

npm install -g mcp-remote

Then add to your agent's configuration:

{
  "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. This gives your AI assistant the full MetaMask Embedded Wallets documentation as a single text file.

warning

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

Add the following URL as a custom doc source in your tool's settings, or paste it directly into your AI chat:

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

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

https://docs.metamask.io/llms-embedded-wallets.txt

Start building​

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

  • "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?"

The MCP server will search the docs and fetch real working examples. The skill will ensure the correct SDK is chosen and common pitfalls are avoided before a line of code is written.

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.

On this page