x402 Ads MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/forgemeshlabs-x402-ads-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

8 read · 0 write · 0 deleteRead-only

Secrets

2 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (8)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• get_category_demandGet Category Demandread-only

  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.

• get_intent_reportGet Intent Reportread-only

  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.

• get_intent_trendsGet Intent Trendsread-only

  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.

• get_network_countersGet Network Countersread-only

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

• get_network_statsGet Network Statsread-only

  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.

• get_termsGet Terms & Data Disclosureread-only

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

• list_toolsList Toolsread-only

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

• preview_recommendationsPreview Recommendationsread-only

  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.

Signals

Stars

1

Forks

0

Open issues

0

Weekly downloads

64

Last commit

Oct 23, 2026 (5 days ago)

Last release

Oct 8, 2026 (20 days ago)

Last package publish

Oct 8, 2026 (20 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.forgemeshlabs/x402-ads-mcp

Version

0.2.5

Auth

API key

Packages

npm @forgemeshlabs/x402-ads-mcp

License

MIT

Repository

github.com/forgemeshlabs/x402-ads-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql