paycrow

Should you pay this agent? Check before sending money. Returns a go/no-go decision with recommended escrow protection parameters. Unlike other trust services, PayCrow ties trust directly to escrow protection: - High trust → shorter timelock, proceed with confidence - Low trust → longer timelock, smaller amounts recommended - Caution → don't proceed, or use maximum protection This is the tool to call BEFORE escrow_create or safe_pay.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Ethereum address of the agent you're about to pay"
    },
    "intended_amount_usdc": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 100,
      "description": "How much you plan to pay (helps calibrate the recommendation)"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full trust score breakdown for an agent address. Aggregates 4 on-chain sources: PayCrow escrow history, ERC-8004 agent identity, Moltbook social karma, and Base chain activity. Returns 0-100 score with per-source details. For a quick go/no-go decision, use trust_gate instead.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Ethereum address of the agent to look up"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Quick on-chain reputation check using only the PayCrow Reputation contract. Free, no API keys needed. Use trust_score_query for the full composite score.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Ethereum address of the agent to look up"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a USDC escrow with built-in dispute resolution. Funds are locked on-chain until delivery is confirmed (release) or a problem is flagged (dispute). If disputed, an arbiter reviews and rules — the only escrow service with real dispute resolution on Base.

{
  "type": "object",
  "properties": {
    "seller": {
      "type": "string",
      "description": "Ethereum address of the seller/service provider"
    },
    "amount_usdc": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 100,
      "description": "Amount in USDC (e.g., 5.00 for $5)"
    },
    "timelock_minutes": {
      "type": "number",
      "minimum": 5,
      "maximum": 43200,
      "default": 30,
      "description": "Minutes until escrow expires and auto-refunds (default: 30)"
    },
    "service_url": {
      "type": "string",
      "description": "URL or identifier of the service being purchased (used for tracking)"
    }
  },
  "required": [
    "seller",
    "amount_usdc",
    "service_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Confirm delivery and release escrowed USDC to the seller. Only call this when you've verified the service/product was delivered correctly.

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "type": "string",
      "description": "The escrow ID to release"
    }
  },
  "required": [
    "escrow_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Flag a problem with delivery — PayCrow's key differentiator. Locks escrowed funds and triggers arbiter review. Unlike other escrow services that say 'no disputes, no chargebacks', PayCrow has real on-chain dispute resolution. Use when service was not delivered or quality was unacceptable.

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "type": "string",
      "description": "The escrow ID to dispute"
    },
    "reason": {
      "type": "string",
      "description": "Brief description of the problem for the arbiter"
    }
  },
  "required": [
    "escrow_id",
    "reason"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check the current state of an escrow (funded, released, disputed, expired, etc.)

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "type": "string",
      "description": "The escrow ID to check"
    }
  },
  "required": [
    "escrow_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Rate a completed escrow. After escrow_release, rate the seller's service quality (1-5 stars). This builds the reputation data that makes PayCrow's trust scores meaningful over time. Both sides can rate: buyer rates seller's service quality, seller rates buyer's conduct. Ratings are on-chain and permanent — they feed directly into trust scoring.

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "type": "string",
      "description": "The escrow ID to rate (must be in Released state)"
    },
    "stars": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Rating 1-5 stars (1=terrible, 5=excellent)"
    }
  },
  "required": [
    "escrow_id",
    "stars"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The smart way to pay an agent. Checks their trust score first, then auto-configures escrow protection based on risk. Flow: Check trust → Set protection level → Create escrow → Call API → Verify → Auto-release or auto-dispute. Protection levels (automatic): - High trust agent → 15min timelock, proceed normally - Moderate trust → 60min timelock, payment capped at $25 - Low trust → 4hr timelock, payment capped at $5 - Unknown/caution → BLOCKED — will not send funds This is the recommended tool for paying any agent. If you need manual control, use x402_protected_call instead.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The API endpoint URL to call"
    },
    "seller_address": {
      "type": "string",
      "description": "Ethereum address of the agent you're paying"
    },
    "amount_usdc": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 100,
      "description": "Amount to pay in USDC"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "DELETE"
      ],
      "default": "GET",
      "description": "HTTP method (default: GET)"
    },
    "headers": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "HTTP headers to include"
    },
    "body": {
      "type": "string",
      "description": "Request body (for POST/PUT)"
    }
  },
  "required": [
    "url",
    "seller_address",
    "amount_usdc"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Make an HTTP API call with manual escrow protection. Full control over verification and timelock parameters. For most payments, use safe_pay instead — it auto-configures protection based on seller trust. Use x402_protected_call when you need: - Custom JSON Schema verification (not just "valid JSON + 2xx") - Hash-lock verification (exact response match) - Specific timelock durations - To override safe_pay's trust-based amount limits

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The API endpoint URL to call"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "DELETE"
      ],
      "default": "GET",
      "description": "HTTP method"
    },
    "headers": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "HTTP headers to include"
    },
    "body": {
      "type": "string",
      "description": "Request body (for POST/PUT)"
    },
    "seller_address": {
      "type": "string",
      "description": "Ethereum address of the API provider (seller) who will receive payment"
    },
    "amount_usdc": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 100,
      "description": "Amount to pay in USDC"
    },
    "timelock_minutes": {
      "type": "number",
      "minimum": 5,
      "maximum": 43200,
      "default": 30,
      "description": "Minutes until escrow expires"
    },
    "verification_strategy": {
      "type": "string",
      "enum": [
        "schema",
        "hash-lock"
      ],
      "default": "schema",
      "description": "How to verify the response: 'schema' (JSON Schema) or 'hash-lock' (exact hash match)"
    },
    "verification_data": {
      "type": "string",
      "description": "Verification data: JSON Schema string (for schema strategy) or expected hash (for hash-lock)"
    }
  },
  "required": [
    "url",
    "seller_address",
    "amount_usdc",
    "verification_data"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}