Fresh402 Agent Intelligence MCP server

Fresh402 v2.2 — Web Intelligence API for AI Agents

Check whether a source changed, extract usable content, and compare structured snapshots. Pay per call with x402 USDC on Base.

The hosted production API reports 2.2.0. Connect at fresh402.kirilllabs.workers.dev or its MCP endpoint. This documentation describes the hosted service; the repository's legacy implementation and backend release PR are maintained separately. A documentation release does not deploy the service.

Choose the operation

• Register once to establish a persistent baseline and receive a watch_id. Re-registering the same watch returns its existing baseline without loading the target again.
• Check before reusing a web source or spending on downstream browsing and reasoning. Get a change signal, noise filtering, conditional HTTP revalidation and an optional compact deterministic text diff. A cached Check is still a paid operation.
• Extract when an agent needs content for retrieval: text, titles, metadata, headings, links and JSON-LD from public HTML, JSON or text, with optional CSS scoping.
• Smart Diff when the change itself matters: compare a watch with its previous Smart Diff snapshot or fixed baseline, get structured additions/removals/modifications, and inspect significance scores with explainable deterministic rules.

Requests fetch eligible public HTTPS sources on demand. Fresh402 does not execute page JavaScript, render a browser, access authenticated sites, perform LLM-powered semantic analysis, continuously poll watches, or send push alerts. Security checks and rate, size, concurrency and operation limits apply; capacity failures may require a later retry.

Start with discovery

• Live OpenAPI 3.1 reference: current request schemas, examples, response formats and payment headers.
• API guide, MCP integration, pricing, request examples.
• x402 resource manifest, agent guide, release notes.
• Official MCP Registry: the existing identity is io.github.kirillradchenko96/fresh402.
• Discovery audit: externally verified catalog status and outstanding reindexing or authorization requirements.

Free service metadata and MCP initialize / tools/list let a new agent learn all four tools without paying or fetching a target.

REST quick start

Register a baseline for free:

curl https://fresh402.kirilllabs.workers.dev/v1/register \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/"}'

Use the returned watch_id in a Check or Smart Diff. The following unsigned request retrieves payment requirements, not a paid result:

curl -i https://fresh402.kirilllabs.workers.dev/v2/extract \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/","max_chars":20000}'

Shortened. The full README is on GitHub.