# PayCrow — The Trust Layer for Agent Commerce
# PayPal for autonomous agents. Escrow + Trust + Dispute Resolution on Base.

> The only escrow service with real on-chain dispute resolution on Base/EVM.
> x402 handles payments. Bazaar handles discovery. PayCrow handles trust.

## What PayCrow Does
1. **Trust Scoring** — Vet agents before paying. 4 on-chain sources (PayCrow escrow history, ERC-8004 identity, Moltbook karma, Base chain activity). Score 0-100 with confidence.
2. **Smart Escrow** — USDC locked in smart contract until delivery confirmed. Auto-release on success, auto-dispute on failure.
3. **Dispute Resolution** — The only escrow on Base with real arbiter review. Competitors say "no disputes, no chargebacks." We solve that.

## How to Use
```
# Install MCP server
npm install -g paycrow
npx paycrow

# Or connect via HTTP
POST https://paycrow-app.fly.dev/mcp
```

## 9 MCP Tools
- **safe_pay** — Smart payment: trust check → escrow → API call → auto-resolve. The recommended way to pay any agent.
- **trust_gate** — Go/no-go decision with recommended escrow params. Call BEFORE paying.
- **trust_score_query** — Full 4-source trust breakdown.
- **trust_onchain_quick** — Free on-chain-only reputation check.
- **escrow_create** — Create USDC escrow with dispute resolution.
- **escrow_release** — Confirm delivery, release funds to seller.
- **escrow_dispute** — Flag bad delivery, lock funds for arbiter.
- **escrow_status** — Check escrow state.
- **x402_protected_call** — Advanced escrow with custom verification (JSON Schema / hash-lock).

## API Endpoints
- GET /trust/{address} — Trust score query ($0.001 USDC via x402)
- GET /trust/{address} (no payment) — Free preview (score + recommendation, no source breakdown)
- POST /mcp — MCP-over-HTTP (Streamable HTTP)
- GET /discovery/resources — x402 Bazaar catalog
- GET /.well-known/agent.json — A2A agent card
- GET /.well-known/x402 — x402 manifest
- GET /health — Health check
- GET /stats — Usage stats

## Payment
Network: Base (eip155:8453)
Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
Amount: $0.001 per trust query
Facilitator: https://facilitator.xpay.sh

## Smart Contracts (Base Mainnet)
Escrow: 0xDcA5E5Dd1E969A4b824adDE41569a5d80A965aDe
USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913