X402 Ads MCP Server

by forgemeshlabsio.github.forgemeshlabs/x402-ads-mcpv0.2.5

Agent demand analytics, recommendations and discovery on the ForgeMesh x402 Ads network, which monetizes unused 402 responses, paid per call in USDC on Base.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install X402 Ads MCP server

claude mcp add x402-ads -e WALLET_PRIVATE_KEY='<wallet-private-key>' -e X402_ADS_PUBLISHER_KEY='<x402-ads-publisher-key>' -- npx -y @forgemeshlabs/x402-ads-mcp

{
  "mcpServers": {
    "x402-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-ads-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<wallet-private-key>",
        "X402_ADS_PUBLISHER_KEY": "<x402-ads-publisher-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "x402-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-ads-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<wallet-private-key>",
        "X402_ADS_PUBLISHER_KEY": "<x402-ads-publisher-key>"
      }
    }
  }
}

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

{
  "servers": {
    "x402-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-ads-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<wallet-private-key>",
        "X402_ADS_PUBLISHER_KEY": "<x402-ads-publisher-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "x402-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-ads-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<wallet-private-key>",
        "X402_ADS_PUBLISHER_KEY": "<x402-ads-publisher-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
WALLET_PRIVATE_KEY	—	yes	Optional dedicated low-balance Base wallet private key for settling paid x402 analytics calls. Without it, paid tools return the x402 payment challenge instead of settling.
X402_ADS_PUBLISHER_KEY	—	yes	Optional publisher key from ads.forgemesh.io. Makes get_intent_report free for your registered services.

Freshness

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

Last commit (default branch)
2026-10-08 · 2d ago · GitHub
Latest release
2026-10-08 · 2d ago · GitHub · v0.2.5
Package published
no data · npm/PyPI
Registry entry updated
2026-10-08 · 2d ago · official registry · v0.2.5

FAQ

›How do I install the X402 Ads MCP server in Claude Code?

Run: claude mcp add x402-ads -e WALLET_PRIVATE_KEY='<wallet-private-key>' -e X402_ADS_PUBLISHER_KEY='<x402-ads-publisher-key>' -- npx -y @forgemeshlabs/x402-ads-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does X402 Ads require an API key?

Yes. It expects WALLET_PRIVATE_KEY, X402_ADS_PUBLISHER_KEY, of which 2 are secrets.

›Can I use X402 Ads as a remote (hosted) MCP server?

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

›Is X402 Ads in the official MCP registry?

Yes, as io.github.forgemeshlabs/x402-ads-mcp.