X402 Ads Mcp

io.github.forgemeshlabsPublished by GitHub account forgemeshlabsv0.2.6Updated Nov 3, 2026

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

VerifiedSTDIODesktop onlyFinance Data & Analytics Business & Commerce

Server details

Identifier: io.github.forgemeshlabs/x402-ads-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account forgemeshlabs for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.forgemeshlabs%2Fx402-ads-mcp.svg)](https://sourceweft.com/mcp/io.github.forgemeshlabs%2Fx402-ads-mcp?utm_source=readme&utm_medium=badge)

Overview

X402 Ads's local MCP server; no sign-in required; STDIO; 8 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

Open X402 Ads Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@forgemeshlabs/x402-ads-mcp

[M8ven Score] [mcpservers.org]

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

json

{  "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)"      }    }  }}

{  "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):

bash

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

# read the terms first: https://ads.forgemesh.io/termsWALLET_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

Tool	Price	What it returns
`get_network_counters`	free	Live network totals: 402s observed, agent-class requests, recommendations served
`preview_recommendations`	free	The exact recommendations block the middleware injects into a 402
`get_terms`	free	Canonical terms + complete data-collection disclosure
`get_network_stats`	$0.005	Network totals + monitor/indexer/agent classification split
`get_intent_trends`	$0.01	Top endpoints & categories autonomous agents request
`get_category_demand`	$0.02	Demand depth for one category: volume, buyer share, price points
`get_intent_report`	$0.05 / free*	Why-agents-didn't-buy funnel for one service

* get_intent_report is free with X402_ADS_PUBLISHER_KEY for services you contribute events to — the data co-op rule: your own data is free, forever.

Environment

Variable	Required	Purpose
`WALLET_PRIVATE_KEY`	no	Base mainnet wallet holding USDC; enables automatic settlement of paid tools
`X402_ADS_PUBLISHER_KEY`	no	Publisher key from ads.forgemesh.io; free lane for your own reports
`X402_MAX_PRICE_USD`	no	Per-call price cap in USD; can only LOWER the built-in cap ($0.05, or $0.10 for `register`)
`X402_SESSION_BUDGET_USD`	no	Cumulative cap per process; can only LOWER the built-in $10

The backend URL is fixed to https://ads.forgemesh.io (the publisher key is only ever sent there). The server refuses to sign for any payee other than the ForgeMesh Ads wallet, any network other than Base mainnet, any asset other than USDC, or any amount over the cap. Use a dedicated, low-balance wallet. 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)

bash

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

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

No test settles a payment. The challenge test deletes the payment env vars before loading, so it cannot move funds even if your shell has a wallet configured.

The network in one sentence

We measure machine commerce, not API content — publishers running the @forgemeshlabs/x402-ads middleware contribute anonymized 402 probe metadata; this MCP sells the aggregate demand signal back to agents and builders.

Full disclosure of what publishers send (and never send): https://ads.forgemesh.io/terms

License

MIT © ForgeMesh

Source: README.md at commit 28652b6

Tools

list_tools

List Tools

Free. Lists every x402 Ads tool with its live price, so an agent can pick before paying. Fetches GET /menu with no payment.

Takes no parameters.

get_network_counters

Get Network Counters

Free. Live totals for the ForgeMesh machine-commerce network: 402 responses observed, agent-class requests, recommendations served, services reporting, and x402 services indexed.

Takes no parameters.

preview_recommendations

Preview Recommendations

Free. See the exact typed recommendations block (sponsored + similar x402 services) that the @forgemeshlabs/x402-ads middleware would inject into a 402 response for a given endpoint and category.

Parametersservicecategoryendpoint

get_network_stats

Get Network Stats

Paid, $0.005 USDC on Base via x402. Network-wide intent stats: total events, services, monitor/indexer/agent traffic classification split, and ad activity. Without WALLET_PRIVATE_KEY, returns the x402 payment challenge instead of settling.

Takes no parameters.

get_intent_trends

Get Intent Trends

Paid, $0.01 USDC on Base via x402. Google-Trends-for-agents: top requested x402 endpoints and categories by autonomous agents, split by traffic class. Without WALLET_PRIVATE_KEY, returns the x402 payment challenge instead of settling.

Parameterslimitwindow

get_category_demand

Get Category Demand

Paid, $0.02 USDC on Base via x402. Demand depth for one category: probe volume, distinct sources, buyer-class share, price points probed, daily series. Without WALLET_PRIVATE_KEY, returns the x402 payment challenge instead of settling.

Parameterswindowcategoryrequired

get_intent_report

Get Intent Report

Why-agents-didn't-buy funnel for one service: bounce funnel, traffic classes, top abandoned endpoints, retry signals. FREE with X402_ADS_PUBLISHER_KEY for your registered services (the service id is bound to your key at registration); otherwise $0.05 USDC on Base via x402. Without a publisher key or WALLET_PRIVATE_KEY, returns the x402 payment challenge.

Parameterswindowservicerequired

get_terms

Get Terms & Data Disclosure

Free. The network's canonical terms of service and complete data-collection disclosure: exactly what the middleware sends and never sends.

Takes no parameters.

Version history

v0.2.6LatestNov 3, 2026
v0.2.5Oct 8, 2026
v0.2.3Oct 5, 2026
v0.2.2Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts