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/checkwith 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/mcpwith a pass, or local withuvx unfret-mcp, paying from a pass or the agent's own Solana wallet. -
Python client
check(url)givesallow,warnorblock, 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.
deep $0.20
Full check: everything in quick, plus an AI read of the listing, the reviews, the product photo in our image index, the price history, domain age and the EU VAT register. The same check a shopper gets.
One check with a pass. Median time on dev.unfret.net: 9.9 s.
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).
| Limit | Value |
|---|---|
/v1/check requests | 30 a minute per pass (with x402: per network) |
| Quick checks | 10 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_content | up to 2 MB |
| A deep check | answers within 60 s with x402 and 90 s with a pass, or is free |
| Developer pass | 20 free deep checks; one a day per network |
| Free deep checks, everyone together | a 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.
| Setting | Default | |
|---|---|---|
UNFRET_PASS | Pay from this Unfret pass; no wallet needed | |
UNFRET_MCP_KEYPAIR | The agent's Solana keypair file | |
UNFRET_MCP_MAX_PRICE_USD | 0.25 | Refuse any single check worth more |
UNFRET_MCP_SESSION_CAP_USD | 2.50 | Refuse once the session has spent this much |
UNFRET_MCP_PAY_WITH | USDC | SOL 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
- Ask.
POST https://unfret.net/v1/checkwith{"url", "tier", "policy"}, andpage_content(the page's HTML) for marketplaces such as Amazon that refuse server-side visits. - Pay. The answer is
402with aPAYMENT-REQUIREDheader listing what it accepts: USDC and wSOL on Solana, schemeexact. Unfret (or, on Base, the facilitator) pays the network fee, so you pay only the price. On Base you sign a USDCtransferWithAuthorization, and it is settled only once the answer is ready. - 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.
Machine-readable
- llms.txt: the service described for language models
- /.well-known/x402: tiers, prices, assets, policies and the pass
- openapi.json and the API reference; from any language: the HTTP guide
- accuracy-history.json and accuracy.json: how often each verdict is right with every scorer version published (the one unfret.net runs included) and with the open baseline, from the accuracy page
- Source code, MIT licensed, including the open baseline scorer, the MCP server and the clients
Coming next
- x402 on Base: pay in USDC on Base, next to Solana, so agents with an EVM wallet can use Unfret too.
- The MCP server on Base: paying from an EVM wallet, next to Solana.
Unfret is run by one person: there's no SLA, and a verdict is a signal, not a certainty. How often it's right, measured.