For developers and AI agents

Ask Unfret before your agent pays

One call per check: does this shop, listing, second-hand ad or tradesperson's site show signs of a scam, dropshipped generic goods, fake reviews or pressure tricks? The answer is an action, allow, warn or block, with the evidence behind it. No account: pay per call over x402, or use an Unfret pass. A developer pass comes with 20 free deep checks.

From any language: the HTTP guide, with curl, JavaScript, Go and PHP.

# one check, with an Unfret pass
curl https://unfret.net/v1/check -H "Authorization: Bearer $UNFRET_PASS" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://unfret.net/test-shop", "tier": "deep"}'

# → 200
{"action": "block", "band": "junk_or_scam",
 "risk_score": 1.0, "flags": [ … ]}

Three ways in

The same analysis a shopper gets in the browser extension, for your agent or your code.

  • HTTP

    POST /v1/check with an Unfret pass as a bearer token, or paid per call over x402 in USDC or wSOL. Unfret pays the network fee. From any language: the request, the response, errors and examples.

  • MCP server

    Remote at https://unfret.net/mcp with a pass, or local with uvx unfret-mcp, paying from a pass or the agent's own Solana wallet.

  • Python client

    check(url) gives allow, warn or block, from a policy you can change. Other languages: plain HTTP.

Try it in three lines

With an Unfret pass. A deep check uses one of the pass's checks; "tier": "quick" is free. The test shop below is a made-up store with every trick Unfret catches.

curl https://unfret.net/v1/check -H "Authorization: Bearer $UNFRET_PASS" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://unfret.net/test-shop", "tier": "deep"}'

With x402. Without a pass the first call answers 402, with the price in a PAYMENT-REQUIRED header. Pay one of its options from a wallet (any x402 client, or unfret-mcp) and send the same request again with the payment:

curl -i https://unfret.net/v1/check -H "Content-Type: application/json" \
  -d '{"url": "https://unfret.net/test-shop", "tier": "deep"}'   # → 402 + PAYMENT-REQUIRED
curl https://unfret.net/v1/check -H "PAYMENT-SIGNATURE: $PAYMENT" -H "Content-Type: application/json" -d '…'

Get a developer pass

20 free deep checks, to build and test your agent with: a few seconds of work in this browser, no account. One per browser, and one a day per network. Quick checks are always free.

Or in code: Unfret().new_developer_pass() (Python), or GET /v1/keys/challenge, then POST /v1/keys with the solved challenge and "developer": true (the proof of work, step by step). Buy checks for any pass.

A full response

Unfret's answer for the test shop: a deep check with a pass, recorded on dev.unfret.net on 2026-11-18. With x402 the body is the same without the pass's four fields (charged, free_check, free_checks_left, balance_usd_micros), and comes with a PAYMENT-RESPONSE header.

{
  "action": "block",
  "assessed": true,
  "risk_score": 1.0,
  "confidence": 0.9891,
  "flags": [
    {
      "type": "timer_resets",
      "evidence": "This countdown restarts when you reload the page: the deadline isn't real.",
      "weight": 1.0,
      "label": "Fake countdown",
      "severity": "high"
    },
    {
      "type": "preticked_addon",
      "evidence": "A paid extra is ticked for you in advance (“Add Worry-Free Delivery Protection (+$4.99)”). That's not allowed in the EU: untick it if you don't want it.",
      "weight": 1.0,
      "label": "Paid extra already ticked",
      "severity": "high"
    },
    {
      "type": "implausible_discount",
      "evidence": "79% off: discounts this deep are almost always measured against a price nobody paid.",
      "weight": 1.0,
      "label": "Unbelievable discount",
      "severity": "high"
    }
  ],
  "policy_applied": "balanced",
  "tier": "deep",
  "cached": false,
  "source": "analysis",
  "checked_at": "2026-11-18T05:25:56.338132Z",
  "model_version": "v1-20261109-222323-C",
  "band": "junk_or_scam",
  "summary": "Fake countdown and paid extra already ticked.",
  "page_type": "storefront",
  "charged": true,
  "free_check": true,
  "balance_usd_micros": 0,
  "free_checks_left": 16
}

action follows the request's policy (strict, balanced or lenient); band is what a shopper would see: reliable "Looks fine", concerns "Worth a look", careful "Think twice", junk_or_scam "Serious concerns". Flags are evidence, never a verdict that a shop is a scam.

Prices, speed and limits

In US dollars: USDC pays them exactly, wSOL at the live SOL/USD price. A page Unfret can't read or assess costs nothing, and paying twice for the same request is impossible.

quick $0.01

Quick first-pass filter: rule-based checks of the page itself (discount tricks, dropshipping and review-import apps, countdown timers and pre-ticked add-ons, hidden text aimed at AI, missing legal information, shipping and return terms, shops sharing accounts). No AI read of the page, no reviews, photo, domain age or registry lookups.

Free with a pass. Median time on dev.unfret.net: 0.2 s.

A quick answer's deep_check says whether a deep check is worth it for that page and what it would add, so an agent escalates only when it helps.

Times: the median of 5 fresh deep and 5 quick checks of the test shop on dev.unfret.net (the test server, on 2026-11-18), from request to answer, with Unfret fetching the page; deep ranged 6.2 s–11.7 s. Production runs on other hardware and other pages take more or less time; these are dev's figures, not a promise. A check of a page Unfret looked at in the last day can come back sooner ("cached": true), charged the same. Checks for a pass come in packs: 25 for $6.00, 100 for $20.00 (buy checks).

LimitValue
/v1/check requests30 a minute per pass (with x402: per network)
Quick checks10 a minute per pass
Pages Unfret fetches for you (no page_content)10 a minute per pass
Checks that ran but weren't charged (page not assessable, client hung up) 30 an hour per pass
page_contentup to 2 MB
A deep checkanswers within 60 s with x402 and 90 s with a pass, or is free
Developer pass20 free deep checks; one a day per network
Free deep checks, everyone togethera daily budget; once it's used: 429 FREE_CHECKS_PAUSED until 00:00 UTC (bought and quick checks go on)

The MCP server

For Claude, Cursor and any MCP client. Every tool has a title and explicit hints: the free check is read-only, the deep one spends a check, and both read a third-party page.

Remote, with a pass

Streamable HTTP at https://unfret.net/mcp, authenticated with an Unfret pass. It never pays from a wallet. Tools: check_store_quick (free), check_store_deep (one of the pass's checks), get_checks_left and get_pricing. In Claude Code:

claude mcp add --transport http unfret https://unfret.net/mcp \
  --header "Authorization: Bearer $UNFRET_PASS"

Or in a client's JSON settings:

{"mcpServers": {"unfret": {
  "type": "http", "url": "https://unfret.net/mcp",
  "headers": {"Authorization": "Bearer ufk_…"}}}}

Local, with a pass or a wallet

unfret-mcp (on PyPI, and in the MCP registry as net.unfret/mcp) runs next to your agent with uv. Tools: check_store (with a tier), explain_flag and get_pricing. With a pass:

{"mcpServers": {"unfret": {
  "command": "uvx", "args": ["unfret-mcp"],
  "env": {"UNFRET_PASS": "ufk_…"}}}}

Or paying each check from the agent's own Solana wallet, in USDC, or wSOL when that's what the wallet holds, refusing to spend beyond its caps:

{"mcpServers": {"unfret": {
  "command": "uvx", "args": ["unfret-mcp"],
  "env": {"UNFRET_MCP_KEYPAIR": "~/.config/solana/agent.json"}}}}

Give the agent a wallet of its own holding only what it may spend, never your main wallet. Paying from a pass (UNFRET_PASS) needs version 0.2.0 or newer.

SettingDefault
UNFRET_PASSPay from this Unfret pass; no wallet needed
UNFRET_MCP_KEYPAIRThe agent's Solana keypair file
UNFRET_MCP_MAX_PRICE_USD0.25Refuse any single check worth more
UNFRET_MCP_SESSION_CAP_USD2.50Refuse once the session has spent this much
UNFRET_MCP_PAY_WITHUSDCSOL to always pay in wSOL
Try it with test money first

On Solana devnet, against Unfret's test server: free test SOL from solana airdrop, test USDC from Circle's faucet.

{"mcpServers": {"unfret": {
  "command": "uvx", "args": ["unfret-mcp"],
  "env": {"UNFRET_MCP_KEYPAIR": "~/.config/solana/devnet-agent.json",
          "UNFRET_MCP_NETWORK": "solana-devnet",
          "UNFRET_API_URL": "https://dev.unfret.net"}}}}

A Python client, and any other language

Python: unfret-client, MIT licensed, with a pass: check(url) answers allow, warn or block from the verdict a shopper would see ("Looks fine" → allow, "Worth a look" → warn, "Think twice" and "Serious concerns" → block; change it with policy).

From PyPI once its first release is out (it comes with Unfret's next release):

pip install unfret-client

Until then, from the source:

pip install "unfret-client @ git+https://git.kroshtan.com/kroshtan/unfret_backend.git#subdirectory=clients/python"
from unfret_client import Unfret

decision = Unfret(pass_="ufk_…").check("https://shop.example/p/42")
if decision.action == "block": ...

Any other language: it's one HTTPS call. Use Unfret from any language has the request, the response, the errors and the developer pass's proof of work, with examples in curl, JavaScript, Go and PHP. For JavaScript and TypeScript there is also a reference client without dependencies in the repository, to copy into a project (it isn't on npm).

The source: Python client, TypeScript reference client, and an example agent that checks the shop before checkout.

HTTP with x402, step by step

  1. Ask. POST https://unfret.net/v1/check with {"url", "tier", "policy"}, and page_content (the page's HTML) for marketplaces such as Amazon that refuse server-side visits.
  2. Pay. The answer is 402 with a PAYMENT-REQUIRED header listing what it accepts: USDC and wSOL on Solana, scheme exact. Unfret (or, on Base, the facilitator) pays the network fee, so you pay only the price. On Base you sign a USDC transferWithAuthorization, and it is settled only once the answer is ready.
  3. Ask again with the payment in PAYMENT-SIGNATURE. The same payment always gets the same answer and is never charged twice.

Every error is JSON with detail and error_code, and says whether you were charged. The full rules, errors and response fields are in llms.txt and the x402 discovery document.

An Unfret pass as an API key

No wallet needed: buy checks by card or iDEAL | Wero (or with crypto), and send the pass as a bearer token to /v1/check (above) or to /v1/analyze, which answers with the shopper's verdict (a band, a headline, reasons and what looks good) and streams progress at /v1/analyze/stream. My checks shows what's left.