Data feeds for agents · x402

Fresh Feeds

Continuously maintained, machine-readable data feeds for AI agents and developers — rebuilt every 30 minutes. Free previews and freshness checks; full snapshots and change-deltas are paid per call over x402, with no account and no API key. This page explains what's in it and how to call it.

Open the live API at fresh-feeds.foomworks.workers.dev →

Running an OpenClaw agent? Fresh Feeds is also published as an installable skill on ClawHub — clawhub.ai/foomworks/fresh-feeds.

What you can pull

1. 01

   MCP server registry

   A deduplicated, quality-scored index of Model Context Protocol servers, rebuilt every 30 minutes. Get the full snapshot, or just what changed since a daily baseline (added, removed, and changed servers) so you only process the delta.

2. 02

   x402 services catalog

   The active edge of the x402 services ecosystem — services that are currently up and correctly demanding payment, liveness-probed so you know a service works before you pay it. Plus a per-server verification report and an embeddable trust badge.

How payment works (x402)

The preview and freshness endpoints are free — plain HTTP GETs you can call from anything. The full snapshots, change-deltas and verification reports are paid per call using x402, an open, HTTP-native micropayment protocol:

1. →

   You request a paid endpoint with no payment. The server answers HTTP 402 Payment Required with the price, the asset (USDC), the network (Base, eip155:8453) and the pay-to address.

2. →

   An x402-capable HTTP client (or a wallet-backed agent) signs the micropayment and retries the request with an X-PAYMENT header. The server verifies it, settles on Base, and returns the data — no account, no API key, no subscription.

3. →

   The exact price for each route, plus the live payTo address and network, are published in the service manifest at GET / — read it at runtime rather than hard-coding values.

Steps to call it

Start free, then pay only when you need the full data.

1 · Browse a free preview

curl https://fresh-feeds.foomworks.workers.dev/feeds/mcp-registry/preview

2 · Check freshness before you pay

/health tells you how old the current snapshot is and which change baselines are available — free, so you can decide whether new data is worth a call.

curl https://fresh-feeds.foomworks.workers.dev/health

3 · Get the full snapshot (paid via x402)

Called directly, a paid route returns 402 with the payment requirements (try it with -i to see the headers). Point an x402-capable client at the same URL and it pays and retries automatically:

# See the 402 + payment requirements
curl -i https://fresh-feeds.foomworks.workers.dev/feeds/mcp-registry

# With an x402-capable client, the same call returns the data
x402 fetch https://fresh-feeds.foomworks.workers.dev/feeds/mcp-registry

4 · Only pay when something changed

The paid feed endpoints support conditional requests. Send the ETag from your last response back as If-None-Match; if nothing changed you get a free 304 Not Modified and pay nothing. To process just the delta, use the cheaper changes endpoint with a baseline date:

# Free 304 if the snapshot is unchanged
curl -i -H 'If-None-Match: "PREVIOUS_ETAG"' https://fresh-feeds.foomworks.workers.dev/feeds/mcp-registry

# Just what changed since a baseline ($0.02)
curl https://fresh-feeds.foomworks.workers.dev/feeds/mcp-registry/changes?since=2026-06-01

Endpoints

Free — no payment, call from anything:

• GET /feeds/mcp-registry/preview free Top 10 MCP servers by quality score.
• GET /feeds/mcp-registry/highlights free Top 10 + trending servers and freshness (powers the live panel above); CORS-enabled.
• GET /feeds/x402-services/preview free Top 10 currently-payable x402 services.
• GET /verify/mcp/preview?server=NAME free Grade + headline liveness for one server.
• GET /verify/mcp/badge?server=NAME free Embeddable SVG trust badge for a server.
• GET /health free Snapshot freshness, data age, and available baseline dates.
• GET /stats free Daily usage counters.
• GET / free Service manifest — the canonical list of endpoints and current prices.

Paid per call via x402 (prices mirror the live manifest):

• GET /feeds/mcp-registry $0.05 Full MCP registry snapshot. Supports ETag / If-None-Match (304, free) to check for new data before paying.
• GET /feeds/mcp-registry/changes?since=YYYY-MM-DD $0.02 What changed since a daily baseline — added, removed and changed servers.
• GET /feeds/x402-services $0.05 Live x402 services with liveness data. Supports ETag / If-None-Match (304, free).
• GET /verify/mcp?server=NAME $0.03 Full verification report — endpoint reachability probe + graded trust signals.

Integrate it

Everything is JSON over plain HTTPS, so any language or agent framework can consume it. A typical loop: poll /health (free) or send a conditional request, and only pay for the full snapshot or the changes delta when the data has actually moved. For MCP server trust, drop the free badge into a README or dashboard:

<img alt="MCP liveness" src="https://fresh-feeds.foomworks.workers.dev/verify/mcp/badge?server=NAME">

Fresh Feeds is built and maintained by an autonomously operated software workshop under human oversight. Feeds are derived from public sources and provided as-is; verify anything consequential against the upstream service. Prices and the pay-to address shown here mirror the live manifest at GET /, which is the canonical source — read it at runtime. No affiliation with, or endorsement by, any listed service is implied.