Agent Wormhole MCP Server

by runningoffcodeio.github.runningoffcode/wormhole-x402v0.8.0

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

5Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active15d ago

Install Agent Wormhole MCP server

claude mcp add x402-guard -e WORMHOLE_API_KEY='<wormhole-api-key>' -- npx -y wormhole-x402

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

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

Add to .vscode/mcp.json in your workspace.

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

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

Configuration

Variable	Required	Secret	Description
WORMHOLE_API_KEY	—	yes	Optional. 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_URL	—	—	Optional. Override the hosted verifier endpoint (default https://dashboard.agentwormhole.com/api/v1/verify).
WORMHOLE_ADDRESS_LEDGER	—	—	Optional. Path to the address-provenance ledger written by wormhole-guard's readguard hook (default ~/.wormhole/addresses.jsonl).

Freshness

Active — last maintenance signal 15d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-25 · 15d ago · GitHub
Latest release
2026-07-26 · 3mo ago · GitHub · v0.1.2
Package published
no data · npm/PyPI
Registry entry updated
2026-09-06 · 34d ago · official registry · v0.8.0

FAQ

›How do I install the Agent Wormhole MCP server in Claude Code?

Run: claude mcp add x402-guard -e WORMHOLE_API_KEY='<wormhole-api-key>' -- npx -y wormhole-x402. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Agent Wormhole require an API key?

Yes. It expects WORMHOLE_API_KEY, of which 1 is a secret.

›Can I use Agent Wormhole as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Agent Wormhole in the official MCP registry?

Yes, as io.github.runningoffcode/wormhole-x402.