# ads.forgemesh.io — ForgeMesh x402 Ads
> Install one middleware. Monetize unused 402 responses with recommendations, discovery, and machine commerce analytics. Publishers enrich their 402 Payment Required bodies with a typed recommendations block (sponsored, similar — more types coming) and stream anonymous probe events; intent analytics are paid per call in USDC on Base mainnet. No API key needed for paid endpoints. We measure machine commerce, not API content — traffic metadata only, never request or response bodies.

## Free (publishers & agents)
POST /v1/decide — free — Get a recommendations block (typed items: sponsored + similar x402 services) for a 402 context. Body: {service, endpoint, category, price}
POST /v1/events — free, x-publisher-key header — Batch-ingest unpaid-probe events from your x402 server
GET /r/{slotId} — free — Tracked redirect to a recommended service
GET /terms — free — Terms of service + complete data-collection disclosure
GET /api/intent/report?service={yours} — FREE for publishers with x-publisher-key on their registered services (the service id is bound to your key at registration; your own data is free)

## Intent Analytics (paid, x402)
POST /v1/publishers/register — $0.10 — Self-serve publisher registration: pay once, paying wallet = your identity, publisher key returned immediately. No emails, no forms, no manual handling. Body: {service_url, terms_accepted: true, name?, categories?, contact?}
GET /api/network/stats — $0.005 — Network totals + traffic classification split
GET /api/intent/trends?window=7d&limit=20 — $0.01 — Top requested endpoints/categories by autonomous agents
GET /api/intent/demand?category={cat}&window=30d — $0.02 — Demand depth for one category
GET /api/intent/report?service={service}&window=30d — $0.05 — Why-agents-didn't-buy funnel report for one service

## Publisher middleware
npm: @forgemeshlabs/x402-ads — one-line Express middleware. Injects the recommendations block into your 402 bodies (fail-open, never touches the x402 challenge header) and reports probe events. Get a publisher key automatically via POST /v1/publishers/register — no emails, no forms, no manual handling.

## MCP server
npm: @forgemeshlabs/x402-ads-mcp — 7 tools for Claude/MCP clients: free network counters, recommendation previews, and terms; paid intent analytics settle via x402 (challenge-first without a wallet; publisher reports free with x-publisher-key).

## Payment
- Network: Base mainnet (eip155:8453)
- Receiving wallet: 0x65E02cB7Fee27630bB7d1a3ADd02Ef7Aa2D21701
- Protocol: x402 (https://x402.org)

## Backlinks / related products
- https://forgemesh.io — ForgeMesh product family
- https://anomaly.forgemesh.io — Anomaly Tracker (x402)
- https://disruption.forgemesh.io — Disruption Intelligence (x402)
- https://x402.coinopai.com — CoinOpAI Kronos signals + agent prompts (x402)
- https://imagegen.coinopai.com — Image generation (x402)

## ForgeMesh Fleet
POST https://x402.forgemesh.io/fleet-products — $0.05 — Paid registry: id, name, host, category, route_count, price_range for every ForgeMesh x402 product
POST https://x402.forgemesh.io/fleet-product-detail — $0.05 — Paid spec sheet: every route, method, price, input schema, worked example for one product
GET https://x402.forgemesh.io/llms.txt — free — Index of the full ForgeMesh Utility Grid, including both registry endpoints above