io.github.jdhart81/agent-surety

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Counterparty risk transfer for the agent economy: agents post bonds behind their promises, wronged c

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "agent-surety": {
      "url": "https://mcp.viridisconservation.com/surety/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• post_bond

  Post a surety bond behind an agent's promises. principal is a positive integer in minor units; expires_at is the ISO-8601 coverage window end. The bond fee (2% default) is computed and frozen at post.

  Parameters:

  • principal_agent (required) — string
  • principal (required) — integer
  • expires_at (required) — string
  • coverage — string
  • currency — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• activate_bond

  Mark a POSTED bond ACTIVE (idempotent). funding_ref links the payment rail transaction that funded the stake.

  Parameters:

  • bond_id (required) — string
  • funding_ref — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• file_claim

  File a claim against an ACTIVE bond. Claims pay out ONLY when an arbitration ruling upholds them (see slash_bond).

  Parameters:

  • bond_id (required) — string
  • claimant (required) — string
  • amount_minor (required) — integer
  • reason — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• slash_bond

  Execute an arbitration ruling against a claim. Requires the ruling's case id + content hash from agent-arbitration — no ruling, no slash; a given ruling pays at most once. Payout caps at the bond's available balance (over-claims exhaust the bond).

  Parameters:

  • bond_id (required) — string
  • claim_id (required) — string
  • ruling_case_id (required) — string
  • ruling_hash (required) — string
  • upheld — boolean

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• release_bond

  Release the remaining stake to the principal after the coverage window elapses — refused while any claim is still open.

  Parameters:

  • bond_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• bond_status

  Current record for a bond (state, balances, claims, audit head).

  Parameters:

  • bond_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_bonds

  List bonds, optionally filtered by state (POSTED|ACTIVE|RELEASED|EXHAUSTED).

  Parameters:

  • state

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• verify_audit

  Validate the tamper-evident audit hash chain for a bond.

  Parameters:

  • bond_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• price_bond

  Underwrite a surety bond: deterministic actuarial premium quote from a counterparty's track record (attestations, notarized deliveries, completed bonds lower the rate; slashes raise it or decline outright). Integer-only model uw-v1; the returned quote_hash lets any party recompute and verify the quote. Pure — never mutates bond state.

  Parameters:

  • coverage_minor (required) — integer
  • duration_days (required) — integer
  • slashes — integer
  • attestations — integer
  • slashed_minor — integer
  • bonds_completed — integer
  • successful_deliveries — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• describe_agent

  Return capabilities and input contract.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.