Skip to content
MCP server

Agent Wormhole

Check tokens, pages and x402 payments before your agent trusts them. Offline verdicts.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.8.0
Listing updated
5 days ago

About Agent Wormhole

Agent Wormhole is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add wormhole-x402 --env WORMHOLE_API_KEY='<WORMHOLE_API_KEY>' -- npx -y wormhole-x402

Add to claude_desktop_config.json

{
  "mcpServers": {
    "wormhole-x402": {
      "command": "npx",
      "args": [
        "-y",
        "wormhole-x402"
      ],
      "env": {
        "WORMHOLE_API_KEY": "<WORMHOLE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wormhole-x402": {
      "command": "npx",
      "args": [
        "-y",
        "wormhole-x402"
      ],
      "env": {
        "WORMHOLE_API_KEY": "<WORMHOLE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "wormhole-x402": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wormhole-x402"
      ],
      "env": {
        "WORMHOLE_API_KEY": "<WORMHOLE_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wormhole-x402": {
      "command": "npx",
      "args": [
        "-y",
        "wormhole-x402"
      ],
      "env": {
        "WORMHOLE_API_KEY": "<WORMHOLE_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "wormhole-x402": {
      "command": "npx",
      "args": [
        "-y",
        "wormhole-x402"
      ],
      "env": {
        "WORMHOLE_API_KEY": "<WORMHOLE_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • WORMHOLE_API_KEYOptional. Hosted-mode key from dashboard.agentwormhole.com: adds URL checks with change history, and the operator's spend policy (budgets, approvals, kill switch) on payments.
  • WORMHOLE_VERIFY_URLOptional. Override the hosted verifier endpoint (default https://dashboard.agentwormhole.com/api/v1/verify).
  • WORMHOLE_ADDRESS_LEDGEROptional. Path to the address-provenance ledger written by wormhole-guard's readguard hook (default ~/.wormhole/addresses.jsonl).

Pricing

Open source

Prices change. Check agentwormhole.com before you buy.

Agent Wormhole FAQ

Is Agent Wormhole free?

Yes. Agent Wormhole is open source, so you can use and self-host it for free.

How do I add Agent Wormhole to Claude Code?

Run this command in your terminal: claude mcp add wormhole-x402 --env WORMHOLE_API_KEY='<WORMHOLE_API_KEY>' -- npx -y wormhole-x402

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers