{
  "markdown": "# paycrow\n\nThe trust layer for agent-to-agent commerce. Escrow protection with **real dispute resolution** for x402 payments on Base.\n\nAgents pay for API calls with USDC via [x402](https://x402.org). But payments are final — no refunds, no disputes, no recourse. Every other escrow service says \"no disputes, no chargebacks.\" **PayCrow is different**: funds are locked until delivery is verified, with on-chain dispute resolution if something goes wrong.\n\nInstall as an MCP server. Your agent gets trust-informed, escrow-protected payments.\n\n## Quick Start\n\n### 1. Generate a wallet\n\n```bash\nnpx paycrow init\n```\n\nCreates a fresh wallet and prints your Claude Desktop config — copy-paste and go.\n\n### 2. Fund it\n\nSend a small amount of ETH (for gas, ~$0.50) and USDC (for payments) to the printed address on **Base**.\n\n### 3. Add to Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"paycrow\": {\n      \"command\": \"npx\",\n      \"args\": [\"paycrow\"],\n      \"env\": {\n        \"PRIVATE_KEY\": \"0x_YOUR_KEY_FROM_INIT\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Done.\n\n### Trust-only mode (no wallet needed)\n\nIf you only want trust scoring without escrow, skip the wallet setup:\n\n```json\n{\n  \"mcpServers\": {\n    \"paycrow\": {\n      \"command\": \"npx\",\n      \"args\": [\"paycrow\"]\n    }\n  }\n}\n```\n\n`trust_gate` and `trust_score_query` work without `PRIVATE_KEY`. Escrow/payment tools will prompt you to set one up.\n\n### Any MCP Client\n\n```bash\nPRIVATE_KEY=0x... npx paycrow\n```\n\nRuns over stdio. Compatible with Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, etc.\n\n## Tools (9 total)\n\n### `safe_pay` — Recommended\n\nThe smart way to pay an agent. Checks their trust score first, then auto-configures escrow protection based on risk.\n\n```\nFlow: Check trust → Set protection → Create escrow → Call API → Verify → Release or dispute\n\nProtection levels (automatic):\n  High trust agent   → 15min timelock, proceed normally\n  Moderate trust     → 60min timelock, $25 cap\n  Low trust          → 4hr timelock, $5 cap\n  Unknown/caution    → BLOCKED — won't send funds\n\nParameters:\n  url               — API endpoint to call\n  seller_address    — Ethereum address of the agent\n  amount_usdc       — Payment amount ($0.10 - $100)\n  method            — GET, POST, PUT, DELETE (default: GET)\n  headers           — HTTP headers (optional)\n  body              — Request body (optional)\n```\n\n### `trust_gate` — Check Before You Pay\n\nShould you pay this agent? Returns a go/no-go decision with recommended escrow parameters.\n\n```\nParameters:\n  address               — Ethereum address to check\n  intended_amount_usdc  — How much you plan to pay (optional)\n\nReturns:\n  decision              — proceed / proceed_with_caution / do_not_proceed\n  escrowParams          — recommended timelock and max amount\n  trustScore            — 0-100 score\n  warning               — if intended amount exceeds safe limit\n```\n\n### `trust_score_query` — Full Breakdown\n\nFull trust score from 4 on-chain sources: PayCrow escrow history (40%), ERC-8004 identity (25%), Moltbook karma (15%), and Base chain activity (20%).\n\n### `trust_onchain_quick` — Free Fast Check\n\nPayCrow reputation only. No API keys needed. Free.\n\n### `x402_protected_call` — Advanced\n\nManual escrow with full control over verification (JSON Schema or hash-lock) and timelock. Use when `safe_pay`'s automatic protection isn't enough.\n\n### `escrow_create`\n\nCreate a USDC escrow with built-in dispute resolution.\n\n### `escrow_release`\n\nConfirm delivery and release funds to the seller.\n\n### `escrow_dispute`\n\nFlag bad delivery. Locks funds for arbiter review — **the only escrow on Base with real dispute resolution**.\n\n### `escrow_status`\n\nCheck the current state of an escrow.\n\n## How It Works\n\n```\nAgent (buyer) ──→ paycrow ──→ Check trust ──→ Create escrow ──→ Call API\n                                                    │\n                                              Verify response\n                                                    │\n                                     ┌──────────────┴──────────────┐\n                                 Valid response              Bad response\n                                     │                            │\n                                Auto-release              Auto-dispute\n                              (seller paid)           (arbiter reviews)\n```\n\n**Escrow lifecycle:**\n\n```\nFUNDED → RELEASED         (delivery confirmed, seller paid minus 2% fee)\n       → DISPUTED → RESOLVED  (arbiter rules: splits funds)\n       → EXPIRED → REFUNDED   (timeout: full refund, no fee)\n```\n\n- 2% protocol fee on release/resolve. Zero fee on refund.\n- $0.10 minimum, $100 maximum per escrow (v1 safety cap).\n- Timelock: 5 minutes to 30 days.\n- On-chain reputation auto-recorded for every escrow outcome.\n\n## Why PayCrow\n\n| Feature | PayCrow | Others |\n|---------|---------|--------|\n| Escrow | Yes (Base, USDC) | Some |\n| **Dispute resolution** | **Yes — on-chain arbiter** | **No — \"no disputes, no chargebacks\"** |\n| Trust scoring | 4 on-chain sources | Limited or none |\n| Trust-informed escrow | `safe_pay` auto-protects | Manual only |\n| MCP server | 9 tools | 0-1 tools |\n| Price | $0.001/trust query | $0.001-0.05 |\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `PRIVATE_KEY` | For escrow tools | Wallet private key (hex, with 0x prefix) |\n| `CHAIN` | No | `\"base\"` for mainnet, defaults to Base Sepolia |\n| `BASESCAN_API_KEY` | No | For Base chain activity data (free at basescan.org) |\n| `MOLTBOOK_APP_KEY` | No | For Moltbook social reputation |\n| `BASE_RPC_URL` | No | Custom RPC URL for Base mainnet |\n\n## Chain\n\n| | Testnet | Mainnet |\n|-|---------|---------|\n| **Network** | Base Sepolia | Base |\n| **USDC** | `0x036CbD53842c5426634e7929541eC2318f3dCF7e` | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |\n| **Gas cost** | ~$0.005/escrow cycle | ~$0.005/escrow cycle |\n\nSet `CHAIN=base` for mainnet. Defaults to Base Sepolia.\n\n## Contract\n\nSolidity smart contracts with:\n- Escrow: full 7-state machine with 2% protocol fee\n- Reputation: on-chain trust scores based on escrow history\n- Dispute resolution: arbiter can review and split funds\n- OpenZeppelin ReentrancyGuard + Pausable\n- 135 tests (unit + fuzz + invariant + integration)\n\nSource: [github.com/michu5696/paycrow](https://github.com/michu5696/paycrow)\n\n## License\n\nMIT",
  "bytes": 6365,
  "sha": "a938abba0ba3a5c01791dac2e5dc58c41b348e7bca89d4068a04d411cf7783f2",
  "repo_slug": "michu5696/paycrow",
  "fonte": "npm",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_michu5696_paycrow_151794d8/readme"
}