MCP.Market

X402 Ads MCP server

by forgemeshlabs·io.github.forgemeshlabs/x402-ads-mcp·v0.2.6·1 stars
No reviews yet

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

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

not scanned yet

Adoption
Growing

1 stars120 downloads/wk

Reviews

Write one

Nobody has reviewed X402 Ads yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

X402 Ads tools

No tool declarations could be read from the package source. They show once the server is installed.

Not scanned yet. New listings are scanned within a day or two of arriving.

How X402 Ads compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 63% of 48,243 servers
GitHub stars
1
more than 65% of 28,706 servers
Downloads a week
120
more than 66% of 12,306 servers with a package

Release history: 3 versions in the registry since 2026-09-01, latest 2026-11-02, typically one every 37 days.

Install X402 Ads in Claude Code, Cursor or VS Code

Runs npx -y @forgemeshlabs/x402-ads-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add x402-ads-mcp -- npx -y @forgemeshlabs/x402-ads-mcp
Add to Cursor

What the publisher says

From the X402 Ads repository's README, as published. We do not edit it. Read it on GitHub

@forgemeshlabs/x402-ads-mcp

Install one middleware. Monetize unused 402 responses with recommendations, discovery, and machine commerce analytics.

This is the MCP side of that network: what autonomous agents probe, want, and abandon across the x402 ecosystem — as tools for your agent.

Wraps the ForgeMesh x402 Ads & Intent Network. Paid tools settle per call in USDC on Base mainnet over the x402 protocol — no account, no API key; your wallet is the login. Publishers get reports on their own services free.

Install

{
  "mcpServers": {
    "intent": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/x402-ads-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x... (optional — enables paid analytics)",
        "X402_ADS_PUBLISHER_KEY": "pub_... (optional — free reports on your own services)"
      }
    }
  }
}

Both env vars are optional. With neither set, free tools work fully and paid tools return the x402 payment challenge (price, network, payTo) instead of settling — useful for inspection before spending anything.

Bonus: one-command publisher registration

This package doubles as the signup CLI for API operators (no MCP client needed):

# read the terms first: https://ads.forgemesh.io/terms
WALLET_PRIVATE_KEY=0xYOUR_WALLET npx -y @forgemeshlabs/x402-ads-mcp register \
  --url https://api.your-service.com --accept-terms

One $0.10 USDC payment on Base; the paying wallet becomes your identity and your publisher key is printed once. Invalid requests are rejected before payment — you can't pay for a doomed registration.

Tools

\ getintentreport is free with X402ADSPUBLISHERKEY for services you contribute events to — the data co-op rule: your own data is free, forever.

Environment

Use a dedicated hot wallet holding only small working balances. The key never leaves your machine — payments are signed locally (EIP-3009) and settle on-chain.

Ready-made configs live in examples/: a Claude Desktop mcpServers block and a commented env-var template.

Testing (safe by construction)

npm test                # smoke: MCP boots over stdio and lists its 7 tools
npm run test:free       # free tools against the live network
npm run test:challenge  # every paid tool returns an x402 challenge — no wallet, nothing can spend
npm run test:all        # all of the above

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

X402 Ads: common questions

Is X402 Ads MCP server safe?
Mostly: it is graded B (82/100). Read the X402 Ads safety report
How do I install X402 Ads?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does X402 Ads need an API key?
Yes. The registry entry asks for WALLET_PRIVATE_KEY, X402_ADS_PUBLISHER_KEY.
Is X402 Ads maintained?
The last commit was 13 days ago (2026-10-23). The latest release is v0.2.6.
How does X402 Ads compare with other MCP servers?
safety score 82/100 (higher than 63% of 48,243 servers); github stars 1 (more than 65% of 28,706 servers); downloads a week 120 (more than 66% of 12,306 servers with a package). Full comparison.

More from forgemeshlabs →