Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

MCP Server

Trezor Suite includes a built-in MCP (Model Context Protocol) server that allows AI agents to interact with your Trezor device. The server runs on localhost only and uses the standard Streamable HTTP transport.

Enabling the MCP Server

  1. Open Trezor Suite Desktop
  2. Go to Settings → Debug (debug settings must be enabled)
  3. Toggle MCP Server on

Once enabled, the server runs at http://127.0.0.1:21340/mcp.

Client Configuration

Add the following to your MCP client configuration:

{
    "mcpServers": {
        "trezor-suite": {
            "url": "http://127.0.0.1:21340/mcp",
            "headers": {
                "Authorization": "Bearer <token>"
            }
        }
    }
}

Replace <token> with the token shown in Trezor Suite (Settings → Debug → MCP Server). Copy the full config snippet for convenience.

Claude Desktop

Add the config to your Claude Desktop configuration file:

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

Claude Code

Add the config to one of:

  • Global: ~/.claude.json
  • Project-level: .mcp.json in your project root

Cursor

  1. Open Cursor Settings
  2. Navigate to the MCP section
  3. Add a new server with the URL http://127.0.0.1:21340/mcp and configure the Bearer token header

VS Code (GitHub Copilot)

Create or edit .vscode/mcp.json in your workspace:

{
    "mcpServers": {
        "trezor-suite": {
            "url": "http://127.0.0.1:21340/mcp",
            "headers": {
                "Authorization": "Bearer <token>"
            }
        }
    }
}

Windsurf

Add the MCP server via Windsurf Settings → MCP using the URL http://127.0.0.1:21340/mcp. Configure the Bearer token header with the token from Trezor Suite.

Available Tools

The MCP server exposes the following tools:

ToolDescriptionDevice confirmation?
trezor_get_addressGet a receive address from the connected deviceOnly if showOnTrezor: true
trezor_get_public_keyGet extended public key (xpub)No
trezor_get_account_infoGet account info (balance, transactions, etc.)No
trezor_send_transactionCompose, sign, and broadcast a transactionYes
trezor_push_transactionBroadcast a signed transaction to the networkNo
trezor_sign_messageSign a message with a device keyYes
trezor_verify_messageVerify a signed messageNo
trezor_sign_typed_dataSign EIP-712 typed data (EVM)Yes

All user-facing tool calls require Suite popup approval (unless previously remembered). Internal auto-fill calls (nonce lookup, fee estimation) run silently.

Claude Code Skill

A ready-made Claude Code skill is available that teaches Claude how to use the MCP tools effectively — including coin/path conventions, transaction auto-fill behavior, and common workflows.

To install it, download the skills/trezor-mcp folder and copy it into Claude Code's skills directory on your machine:

  • macOS / Linux: ~/.claude/skills/trezor-mcp/
  • Windows: %USERPROFILE%\.claude\skills\trezor-mcp\

Make sure the folder contains SKILL.md and the references/ subfolder. Once in place, Claude Code will automatically trigger the skill when you mention Trezor wallet operations.