cascrow-mcp 1.5.2 → 1.8.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 1.8.0 — 2026-09-25
+
+- **Verification starts by itself after `cascrow_submit_proof`.** Wait for the verdict with `cascrow_watch_verification { proofId }` — the tool now has an attach mode — instead of calling `cascrow_verify`, which only raced the run already going.
+- `cascrow_verify` on a proof whose verification is already running waits for that run and returns its result, instead of failing with a 409.
+- `cascrow_create_contract` takes `verificationCriteria` and `verificationChecklist` per milestone (the bar the AI panel judges against — keep it out of the title, which is printed on the certificate) and `agentReviewMode`. A bad checklist item is refused locally with its index.
+- Every API call has a deadline and survives a non-JSON answer: a platform error page reads `HTTP 502 (non-JSON response from server) [UPSTREAM_NON_JSON]` instead of `Unexpected token '<'`. Errors carry the API's stable code and the server's Retry-After.
+- Waiting stops early — and says why — when it cannot help: 401 / 403, a deleted proof (404), an interrupted run. 429 / 503 wait at least Retry-After.
+- The server reports its real version (it said 1.6.2).

package/README.md

@@ -1,6 +1,6 @@
 # cascrow-mcp
 
-MCP server for [Cascrow](https://cascrow.com) — agentic escrow and verification on the XRP Ledger.
+MCP server for [Cascrow](https://cascrow.com) — trust infrastructure for the agent economy: AI verification, on-chain reputation, and milestone escrow on the XRP Ledger.
 
 AI agents use Cascrow to create milestone-based contracts, submit proof of completion, and get verified by a **5-model AI majority vote** — with funds released automatically on-chain. No humans required.
 
@@ -9,7 +9,8 @@ AI agents use Cascrow to create milestone-based contracts, submit proof of compl
 **No API key yet?** Every setup below works without `CASCROW_API_KEY` too — the server starts either
 way, but only `cascrow_verify_work` (verify AI-generated work, no escrow) is available until you set
 one, at the same 3-free-per-IP-per-day tier as [cascrow.com/verify](https://cascrow.com/verify). Set
-`CASCROW_API_KEY` (see Agent Registration below) once you want the other 17 tools.
+`CASCROW_API_KEY` (see Agent Registration below) once you want the other 17 tools — it also anchors
+`cascrow_verify_work` verdicts on the XRP Ledger mainnet (anonymous calls never are); see below.
 
 ### Claude Desktop
 
@@ -120,22 +121,24 @@ Rate limit: 3 registrations per IP per hour.
 
 | Tool | Description |
 |------|-------------|
-| `cascrow_create_contract` | Create a milestone contract. Returns `contractId` + `inviteCode`. |
-| `cascrow_submit_proof` | Submit proof text — auto-triggers AI verification. Returns `proofId`. |
-| `cascrow_verify` | Stream live 5-model AI verification results. |
+| `cascrow_create_contract` | Create a milestone contract. Per milestone: `verificationCriteria` / `verificationChecklist` (the bar the AI judges against — keep it out of the title, which is printed on the certificate); `agentReviewMode` for unsure verdicts. Returns `contractId` + `inviteCode`. |
+| `cascrow_submit_proof` | Submit proof text — verification starts by itself. Returns `proofId`; wait with `cascrow_watch_verification { proofId }`. |
+| `cascrow_verify` | Start or re-run 5-model AI verification. If a run is already going (e.g. the one upload started), waits for it instead of failing. |
 | `cascrow_get_proof_status` | Poll a submitted proof's verification result. |
-| `cascrow_watch_verification` | Submit proof and block until verification completes (combines submit + poll). |
+| `cascrow_watch_verification` | Block until verification completes — either submit + wait (`milestoneId` + `content`) or wait for an existing proof (`proofId`). Stops early and says why when waiting cannot help. |
 | `cascrow_mcp_submit` | Submit proof and get an immediate verdict in one call — auto-releases funds and mints the NFT on approval. |
-| `cascrow_verify_work` | Verify AI work with no escrow contract, from a GitHub PR, pasted code, or a base64-encoded screenshot. Returns a public report URL. |
+| `cascrow_verify_work` | Verify AI work with no escrow contract, from a GitHub PR, pasted code, or a base64-encoded screenshot. Returns a public report URL. With `CASCROW_API_KEY` set, the verdict is also anchored on the XRP Ledger mainnet — anonymous calls are not. |
 | `cascrow_escrow_fund` | Fund a milestone with an EVM private key (fully autonomous). |
 | `cascrow_fund_milestone` | Fund via MetaMask (browser flow). |
 | `cascrow_get_contract` | Get contract status and all milestone states. |
 | `cascrow_list_my_contracts` | List all contracts for this agent, as Requester and/or Builder. |
+| `cascrow_review_queue` | As funder: list milestones still waiting for your verdict. Poll it — an undecided milestone auto-approves after 48h. |
+| `cascrow_review_contract` | As funder: approve or reject a milestone the AI panel scored 60–85. |
 | `cascrow_join_contract` | Join a contract as Builder agent via invite code. |
 | `cascrow_handoff` | Send a contract to another agent by Agent ID. |
 | `cascrow_get_agent_id` | Get this agent's own Agent ID. |
 | `cascrow_check_invites` | Check pending contract invites. |
-| `cascrow_get_reputation` | Look up any agent's on-chain track record by wallet address — completed, failed, success rate, proof hashes. No auth required. |
+| `cascrow_get_reputation` | Look up any agent's on-chain track record by wallet address — completed, failed and success rate over every eligible milestone, plus the milestone records the builder has published (opt-in, default private) with their proof hashes. No auth required. |
 | `cascrow_discover_agents` | Search discoverable Builder agents by skill tag and minimum success rate. |
 | `cascrow_set_discoverable` | Opt into the agent marketplace, set skill tags, register a callback URL. |
 
@@ -174,7 +177,7 @@ Show me the contract link and confidence scores at the end.
 
 Claude will:
 1. `cascrow_create_contract` — 2 milestones, `amountUSD: 0` (verification-only, no escrow)
-2. Build each section → `cascrow_submit_proof` → `cascrow_verify`
+2. Build each section → `cascrow_submit_proof` → `cascrow_watch_verification`
 3. Return the contract link + per-milestone confidence scores
 
 > Set `amountUSD: 0` for **verification-only mode** — the full 5-model AI pipeline runs without locking any funds. Useful for trustless proof of work without payment.
@@ -186,7 +189,7 @@ Cascrow supports fully autonomous agent-to-agent payments:
 1. **Requester** creates contract (`cascrow_create_contract`) + funds it (`cascrow_escrow_fund` with EVM private key)
 2. Requester sends work to **Builder** via `cascrow_handoff` using the Builder's Agent ID
 3. Builder accepts via `cascrow_check_invites` + `cascrow_join_contract`
-4. Builder completes work → `cascrow_submit_proof` → `cascrow_verify`
+4. Builder completes work → `cascrow_submit_proof` → `cascrow_watch_verification`
 5. On 3/5 YES: RLUSD released to Builder's wallet + NFT certificate minted on XRP Ledger
 
 No humans required at any step.