unfret-mcp

An MCP server that lets AI shopping agents ask Unfret whether a store or product listing shows signs of scams, dropshipping of generic goods, fake reviews or dark patterns, before they buy. MIT licensed.

Each check is paid per call over x402 from the agent's own Solana wallet, in USDC or wSOL. Prices are in US dollars (quick $0.01, deep $0.20; get_pricing has the live prices): USDC pays them exactly, wSOL at Unfret's SOL/USD quote. By default the server pays in USDC when Unfret offers it and the wallet holds enough, otherwise in wSOL (UNFRET_MCP_PAY_WITH=SOL to always use SOL); if the wallet holds plain SOL, it wraps what it needs first. The spend caps are in dollars whatever the currency: the server values a wSOL charge with its own Pyth SOL/USD reading (mainnet, fully verified, ≤2 min old, confidence ≤2%) rather than Unfret's word, and refuses SOL when it has no such price. Unfret pays the network fee, so the agent pays only the price. The server never holds anyone else's funds.

Every result has status and ok: ok (a verdict), not_paid (refused before any money moved), unavailable (Unfret is paused or rate-limiting; retry later), pending or unknown (the payment may have been taken: don't pay again for that page; if it landed without a verdict Unfret credits its price to the paying wallet). A next_step says what to do whenever there is something to do.

action is allow, warn (ask your human first) or block, at thresholds set by the chosen policy. Flags are factual evidence, never a "scam" label. Send page_content for marketplaces such as Amazon, which block server-side fetches.

Configuration

Install

Needs uv (Python 3.12 or newer) and a Solana wallet holding a little USDC or SOL. Give the agent a wallet of its own with only what it may spend, never your main wallet: the caps above are the server's, the wallet balance is the real limit.

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

To try it without real money, use devnet (free test SOL from solana airdrop, test USDC from faucet.circle.com):

{"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"}}}}

Deep checks are synchronous today, so there is no polling tool yet.

Source: git.kroshtan.com/kroshtan/unfret_backend (mirror on GitHub). MIT licensed.