Agent Escrow

Official9 toolsLive

by jdhart81 · Python

Trustless escrow & settlement with an exactly-once state machine + audit hash chain.

Captured live from the server via tools/list.

open_escrow

Open an escrow between payer and payee. amount_minor is a positive integer in minor units (cents). The platform fee is computed and FROZEN at open (ceil bps). Returns the escrow_id (state OPEN).

Parameters7

payer	string	required
payee	string	required
amount_minor	integer	required
currency	string	optional
terms	string	optional
deadline	string	optional
fee_bps	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "payer": {
      "title": "Payer",
      "type": "string"
    },
    "payee": {
      "title": "Payee",
      "type": "string"
    },
    "amount_minor": {
      "title": "Amount Minor",
      "type": "integer"
    },
    "currency": {
      "default": "USD",
      "title": "Currency",
      "type": "string"
    },
    "terms": {
      "default": "",
      "title": "Terms",
      "type": "string"
    },
    "deadline": {
      "default": "",
      "title": "Deadline",
      "type": "string"
    },
    "fee_bps": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Fee Bps"
    }
  },
  "required": [
    "payer",
    "payee",
    "amount_minor"
  ],
  "title": "open_escrowArguments"
}

fund_escrow

Mark an OPEN escrow as FUNDED (idempotent). payment_ref links the payment-rail transaction.

Parameters2

escrow_id	string	required
payment_ref	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "title": "Escrow Id",
      "type": "string"
    },
    "payment_ref": {
      "default": "",
      "title": "Payment Ref",
      "type": "string"
    }
  },
  "required": [
    "escrow_id"
  ],
  "title": "fund_escrowArguments"
}

release_escrow

Release a FUNDED/DISPUTED escrow to the payee (exactly-once — a repeat release returns the existing terminal record, never a double payout).

Parameters2

escrow_id	string	required
delivery_proof	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "title": "Escrow Id",
      "type": "string"
    },
    "delivery_proof": {
      "default": "",
      "title": "Delivery Proof",
      "type": "string"
    }
  },
  "required": [
    "escrow_id"
  ],
  "title": "release_escrowArguments"
}

refund_escrow

Refund an OPEN/FUNDED/DISPUTED escrow to the payer (exactly-once). Refunding an OPEN escrow is a cancel.

Parameters2

escrow_id	string	required
reason	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "title": "Escrow Id",
      "type": "string"
    },
    "reason": {
      "default": "",
      "title": "Reason",
      "type": "string"
    }
  },
  "required": [
    "escrow_id"
  ],
  "title": "refund_escrowArguments"
}

dispute_escrow

Move a FUNDED escrow to DISPUTED. An arbiter (agent-arbitration-agent) then resolves it to release or refund.

Parameters2

escrow_id	string	required
reason	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "title": "Escrow Id",
      "type": "string"
    },
    "reason": {
      "default": "",
      "title": "Reason",
      "type": "string"
    }
  },
  "required": [
    "escrow_id"
  ],
  "title": "dispute_escrowArguments"
}

escrow_status

Current record for an escrow.

Parameters1

escrow_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "title": "Escrow Id",
      "type": "string"
    }
  },
  "required": [
    "escrow_id"
  ],
  "title": "escrow_statusArguments"
}

list_escrows

List escrows, optionally filtered by state (OPEN|FUNDED|RELEASED|REFUNDED|DISPUTED).

Parameters1

state

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    }
  },
  "title": "list_escrowsArguments"
}

verify_audit

Validate the tamper-evident audit hash chain for an escrow.

Parameters1

escrow_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "escrow_id": {
      "title": "Escrow Id",
      "type": "string"
    }
  },
  "required": [
    "escrow_id"
  ],
  "title": "verify_auditArguments"
}

describe_agent

Fleet-standard self-description.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "describe_agentArguments"
}

README.md4 KBView on GitHub

Viridis Agent Fleet — MCP Surface

The public MCP-facing surface of the Viridis agent stable: a 13-agent agent-to-agent (A2A) economy published on the Model Context Protocol registry under the earth.viridis namespace. This repository is the callable spec + provenance for those listings — the registry manifests, the JSON-Schema tool definitions, the public agent contracts, and the reference gateway. The agent cores are maintained privately; everything here is what a calling agent needs.

By Viridis LLC — conservation technology.

The economy: identity → trust → escrow → settlement → constitution

Trustworthy agents transacting with agents needs rails. This fleet ships them as composable MCP services:

Layer	Agent	What it provides
Identity	`agent-identity-registry`	Content-addressed agent DIDs + capability discovery — the passport + directory
Trust	`agent-trust-oracle`	Decay-weighted reputation + tamper-evident trust attestations
Settlement	`agent-escrow`	Trustless escrow with an exactly-once state machine + audit hash chain
Metering	`agent-metering`	Usage metering + SLA accounting — the meter behind x402
Arbitration	`agent-arbitration`	Dispute-resolution oracle consuming trust signals
Compute ledger	`agent-compute-ledger`	"Compute is carbon" cost/energy accounting for agent work
Covenant	`agent-covenant`	Deny-by-default authority leases for agents wielding real power
Provenance	`agent-provenance`	Genesis certificates, lineage, cascading recalls
Offsets	`agent-offset-clearinghouse`	Verified-credit carbon accountability — the conservation flywheel
Revenue	`smartscale`	Credit-card-calibrated measurement — the first sellable service
Revenue	`protogen`	MCP CAD services; bundles with SmartScale (measure → CAD)
Revenue	`regulatory-radar`	CSRD/TNFD compliance-as-a-service
Enabler	`narrative-engine`	Grant / investor / policy narrative generation

Layout

code

mcp-publish/<agent>/server.json   # MCP registry manifest (earth.viridis/*)
mcp-publish/<agent>/tools.json    # JSON-Schema tool definitions (one per action)
mcp-publish/<agent>/DEPLOY.md     # env, endpoints, how a caller uses it
contracts/<agent>.md              # public agent contract (capabilities, invariants)
gateway/                          # reference gateway: one process hosts all 13 over streamable-http
docs/A2A_ECONOMY.md               # the full identity→trust→escrow thesis + composition demo

Calling an agent

Every agent is a streamable-HTTP MCP server hosted behind https://mcp.viridis.earth/<path>/mcp (paths in each server.json). Point any MCP client at the URL, or discover them on the registry by searching earth.viridis. Each tools.json is the exact tool surface — one tool per agent action, with typed input/output schemas.

Status

LIVE (2026-07-09). All 13 published on the MCP registry under io.github.jdhart81/* and hosted at https://viridis-agent-stable.fly.dev (/healthz = 13 ok). The as-shipped manifests are in mcp-publish-github/ (the mcp-publish/ set holds the branded earth.viridis variants for the round-1b rebrand + custom domain mcp.viridis.earth).

Round-1 posture: endpoints are open (read-tool posture); no funds move — escrow, offsets, and metering are state machines, with payment rails (x402 for A2A, Stripe for human-facing services) attaching in a later round. See docs/A2A_ECONOMY.md.

Install

Tools (9)

open_escrowfund_escrowrelease_escrowrefund_escrowdispute_escrowescrow_statuslist_escrowsverify_audit

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.viridisconservation.com/escrow/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agent-escrow": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.viridisconservation.com/escrow/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.