Skip to content
MCP server

X402 Ads MCP

x402 ad recommendations, intent analytics, and machine-commerce demand reports.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.7
Listing updated
4 days ago

About X402 Ads MCP

X402 Ads MCP 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 x402-ads-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' --env X402_ADS_PUBLISHER_KEY='<X402_ADS_PUBLISHER_KEY>' -- npx -y @forgemeshlabs/x402-ads-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "x402-ads-mcp": {
      "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

{
  "mcpServers": {
    "x402-ads-mcp": {
      "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

{
  "servers": {
    "x402-ads-mcp": {
      "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 ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402-ads-mcp": {
      "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 your client's MCP settings (most use this shape)

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

Configuration

  • WALLET_PRIVATE_KEYOptional 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_KEYOptional publisher key from ads.forgemesh.io. Makes get_intent_report free for your registered services.

Pricing

Open source

X402 Ads MCP FAQ

Is X402 Ads MCP free?

Yes. X402 Ads MCP is open source, so you can use and self-host it for free.

How do I add X402 Ads MCP to Claude Code?

Run this command in your terminal: claude mcp add x402-ads-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' --env X402_ADS_PUBLISHER_KEY='<X402_ADS_PUBLISHER_KEY>' -- npx -y @forgemeshlabs/x402-ads-mcp