---
name: 402coffee
description: Trust layer for agent payments on x402 / Base. Use to SCORE a counterparty wallet's payment risk before paying it (free GET /verify, paid POST /score), CERTIFY your own agent's payment behaviour for a public credential, or ESCROW an x402 deal with automated on-chain arbitration. Triggers when an agent is about to pay an unknown wallet, needs a trust or risk check on a counterparty, or wants a payment-conformance certificate.
---

# 402.coffee - trust layer for agent payments

Live x402 endpoint on Base (eip155:8453), real USDC, gasless (EIP-3009). Unpaid request -> HTTP 402 -> sign a USDC transferWithAuthorization -> retry with X-PAYMENT. Every result is a fact observed on-chain - never a blanket "safe".

## Score a counterparty before you pay it
- Free: GET https://api.402.coffee/verify?wallet=0x... -> boolean + per-capability detail.
- $0.10: POST https://api.402.coffee/score  body {"wallet":"0x..."} -> deterministic 0-100 with itemized on-chain evidence, tier (A-F), and flags. A fresh behavioural FAIL caps the score at 25.
- $0.50: POST https://api.402.coffee/score/batch  body {"wallets":["0x..."]}  up to 25 wallets.

## Certify your own agent
- GET /inspect (free menu). POST /test/basic ($0.25). POST /test/scam/start and /test/recipient/start ($0.60 total each - pay a fairly-priced control AND refuse the bait/decoy, served in random order). POST /test/suite ($0.75). Returns a public certificate + README badge, valid 30 days.

## Escrow a deal
- GET https://api.402.coffee/escrow -> exact operator / escrow addresses + integration (commerce scheme). Non-custodial; release minus 1% or buyer refund; buyers self-refund after the window if the arbiter is down.

## External arbiter (for ANY escrow)
- $0.25: POST https://api.402.coffee/arbiter/verify  body {"category":"http-delivery|payload-hash|ci-status","conditions":{...}} -> SIGNED release/refund/escalate verdict with evidence; your escrow executes it (non-custodial). $0.60 scored variant embeds both parties' risk tiers. Policy: GET /arbiter/policy. Verdicts public at /arbiter/verdict/{id}.

## Signed credentials
- /credential/0x... and arbiter verdicts carry an Ed25519 detached-JWS proof. Keys: /.well-known/jwks.json. Verify offline: npm i 402coffee-verify-credential (CLI: npx 402coffee-verify-credential 0x...).

## MCP server
- npx -y 402coffee-mcp -> tools: verify_agent, check_credential, list_tests, arbiter_policy, escrow_info (free); score_wallet, score_batch, certify, arbiter_verify (paid via PAYER_PRIVATE_KEY env, local signing).

## Discovery
/openapi.json, /llms.txt, /llms-full.txt, /.well-known/agent.json, /agent-card, /.well-known/jwks.json. ERC-8004 agentId #56900 on Base. Docs: https://api.402.coffee/docs