M2M Escrow Arbiter — Delivery Evidence Review

{
  "name": "M2M Escrow Arbiter \u2014 Delivery Evidence Review",
  "description": "External application-level evidence gate for agent workflows. Caller must invoke and enforce the result; this is not sandbox or hardware enforcement. Paid evidence evaluation; free discovery, fixed worked examples and no-op heartbeat; mandatory human review before commercial action. No independent factual verification or clearance. External evidence review for agent-to-agent delivery disputes and proposed escrow allocations. Checks hashes, a bounded offline JSON Schema subset and SLO evidence. Unsupported schemas require human review; no settlement is executed or authorized. New to these gates? Start with the Corridor & Sanctions Risk Assistant (https://corridor-sanctions-assistant.agendamcp.dpdns.org) for plain-language orientation. Describe the route or counterparty and the next decision or review; fit, scope, fee, and timing are confirmed before work starts.",
  "provider": {
    "organization": "Vassiliy Lakhonin",
    "url": "https://github.com/vassiliylakhonin"
  },
  "version": "1.16.0",
  "documentationUrl": "https://github.com/vassiliylakhonin/agenda-intelligence-md/blob/main/docs/use-cases/m2m-escrow-arbiter.md",
  "supportedInterfaces": [
    {
      "url": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/message/send",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "securityRequirements": [],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false,
    "extensions": [
      {
        "uri": "https://agenda-intelligence-a2a.vassiliy-lakhonin.workers.dev/a2a/extensions/agenda-intelligence/v1",
        "description": "Wrapper scope, product contract, boundaries, support channel and provider identity for this agent. Repeat callers may send the optional X-Client-Id header with a stable non-personal integration label. Descriptive only: reading it is never required to call the agent.",
        "required": false,
        "params": {
          "support": {
            "email": "vassiliy.lakhonin@gmail.com",
            "documentationUrl": "https://github.com/vassiliylakhonin/agenda-intelligence-md/blob/main/MCP.md",
            "hours_local": "Mon\u2013Fri 09:00\u201318:00 Asia/Almaty (UTC+5)",
            "timezone": "Asia/Almaty",
            "response_sla": "Best-effort response within 2 business days. Solo maintainer (not a company); not a paid support channel."
          },
          "x_agenda_intelligence": {
            "hosted_wrapper": true,
            "operational_health": {
              "status": "ok",
              "version": "1.16.0",
              "checked_at": "2026-10-11T21:58:41.102Z",
              "url": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/health"
            },
            "task_continuity": {
              "store": "KV (24-hour TTL, status-only without input or artifacts)",
              "supported_methods": [
                "SendMessage",
                "GetTask"
              ],
              "cancellation": "unsupported for synchronous tasks",
              "tenant_binding": "when TASK_SCOPE_AUTH_REQUIRED=1, task creation issues a private continuation.token; GetTask and continuation require it in X-Task-Token and otherwise answer TASK_NOT_FOUND. X-Client-Id is a telemetry label. Legacy local mode uses label scoping only"
            },
            "wrapper_scope": "A2A/JSON-RPC discovery, lightweight triage, and routing response only",
            "jsonrpc_endpoint": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/message/send",
            "protocol_version": "1.0",
            "public_endpoint": true,
            "optional_client_identifier_header": "X-Client-Id",
            "client_identification": {
              "header": "X-Client-Id",
              "required": false,
              "purpose": "Use a stable non-personal integration label so aggregate stats can group repeat calls; do not send a person's name, email, token, or secret."
            },
            "fleet_directory": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/.well-known/fleet.json",
            "ai_catalog": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/.well-known/ai-catalog.json",
            "oauth_protected_resource": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/.well-known/oauth-protected-resource",
            "repository": "https://github.com/vassiliylakhonin/agenda-intelligence-md",
            "package": "https://pypi.org/project/agenda-intelligence-md/",
            "mcp": {
              "transport": "stdio",
              "server_command": "agenda-intelligence-mcp",
              "install": "pip install agenda-intelligence-md"
            },
            "boundaries": [
              "Micropayments settled directly on Base (Chain ID 8453, USDC); no custody of user funds.",
              "No autonomous live source retrieval.",
              "No factual-truth verification.",
              "No legal, financial, compliance, investment, or trading advice."
            ],
            "x402": {
              "protocol": "x402",
              "network": "base",
              "chain_id": 8453,
              "token": "USDC",
              "token_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "pricing_tiers": {
                "tier_micro_check_usdc": 0.05,
                "tier_bankability_dossier_usdc": 25,
                "tier_pro_monthly_usdc": 490
              },
              "settle_endpoint": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/v1/settle",
              "interactive_web3_ui": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/corridor-bankability"
            },
            "preferred_input": "Structured JSON in message.parts[0].data (mediaType: application/json). JSON serialized in message.parts[0].text is also accepted for compatibility; ordinary prose alone is not sufficient for paid evaluation. Use the request schema and replace illustrative values with supplied evidence.",
            "a2a_send_message_example": {
              "endpoint": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/message/send",
              "headers": {
                "Content-Type": "application/json",
                "A2A-Version": "1.0",
                "X-Trace-Id": "example-trace-001"
              },
              "request": {
                "jsonrpc": "2.0",
                "id": "example-1",
                "method": "SendMessage",
                "params": {
                  "message": {
                    "messageId": "example-msg-1",
                    "role": "ROLE_USER",
                    "parts": [
                      {
                        "data": {
                          "escrow_id": "escrow-m2m-sample-001",
                          "dispute_claim": {
                            "claimant": "buyer",
                            "reason": "Contract deliverable dispute"
                          },
                          "deal_terms": {
                            "buyer_id": "did:agent:0x1111111111111111111111111111111111111111",
                            "seller_id": "did:agent:0x2222222222222222222222222222222222222222",
                            "amount_usd": 500,
                            "currency": "USDC",
                            "deadline_utc": "2026-09-17T18:00:00Z",
                            "arbitration_policy": "pro_rata",
                            "arbitration_fee_pct": 1
                          },
                          "specification": {
                            "deliverable_type": "json_data",
                            "min_valid_records_pct": 95
                          },
                          "delivery_submission": {
                            "submitted_at": "2026-09-17T12:00:00Z",
                            "telemetry": {
                              "total_items": 1000,
                              "valid_items": 1000,
                              "response_time_ms": 320
                            }
                          }
                        },
                        "mediaType": "application/json"
                      }
                    ]
                  }
                }
              },
              "expected": {
                "task_state": "TASK_STATE_COMPLETED",
                "http_status_without_payment": 402,
                "note": "Task completion is the success shape after admission. On paid deployments, a valid unpaid request returns HTTP 402 without evaluation. Triage output only, not authorization or clearance."
              },
              "trace": "Optional: send an X-Trace-Id header (8-80 chars of A-Za-z0-9._:-) or a top-level params.trace_id. It is echoed in task metadata.trace_id and recorded in telemetry, so your call can be correlated end to end."
            },
            "free_a2a_triage": {
              "scope": "Free discovery, fixed examples and no-op heartbeat only. Evidence evaluation is paid.",
              "decision_boundary": "No legal, sanctions, financial or trading clearance. Human review before any commercial action.",
              "price": "Paid evaluations require signed payment or Pro entitlement. See /.well-known/x402."
            }
          },
          "x_security_posture": {
            "transport": "https",
            "public_endpoint": true,
            "required_authentication": false,
            "oauth_protected_resource_metadata": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/.well-known/oauth-protected-resource",
            "optional_client_identifier_header": "X-Client-Id",
            "client_identification": {
              "required": false,
              "authentication": false,
              "purpose": "Pseudonymous repeat-call attribution in aggregate operational analytics."
            },
            "zero_retention_guarantee": false,
            "pricing_url": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/.well-known/x402",
            "privacy_url": "https://m2m-escrow-arbiter.agendamcp.dpdns.org/privacy",
            "data_handling": [
              "Aggregate operational telemetry excludes caller prompt text.",
              "Signed paid execution stores a response for recovery within 24 hours; do not submit secrets.",
              "Voluntary intake and feedback have separate storage and retention rules described in /privacy."
            ],
            "abuse_contact": "mailto:vassiliy.lakhonin@gmail.com"
          },
          "x_tool_contracts": {
            "contract_version": "1.16.0",
            "note": "These are MCP tool schemas, not A2A envelope schemas. For A2A SendMessage use x_agenda_intelligence.a2a_send_message_example; structured gate fields go directly in message.parts[0].data with mediaType application/json. Text-only routing profiles use message.parts[0].text; ordinary prose does not replace a gate's required structured evidence.",
            "tools": [
              {
                "name": "m2m_escrow_arbitration_ruling",
                "input_schema": {
                  "type": "object",
                  "properties": {
                    "request": {
                      "type": "object",
                      "description": "Structured request object. Full contract: https://github.com/vassiliylakhonin/agenda-intelligence-md/blob/main/schemas/v1/m2m-escrow-arbiter-request.schema.json",
                      "additionalProperties": true
                    }
                  },
                  "required": [
                    "request"
                  ],
                  "additionalProperties": false
                },
                "output_schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "title": "M2MEscrowArbiterResponseMcpCompatibility",
                  "type": "object",
                  "anyOf": [
                    {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "title": "M2MEscrowArbiterResponse",
                      "description": "Response contract for delivery-evidence review. Unverified delivery requires human review and cannot authorize settlement.",
                      "x-schema-version": "1",
                      "type": "object",
                      "additionalProperties": false,
                      "required": [
                        "contract_version",
                        "profile",
                        "arbitration_ruling"
                      ],
                      "properties": {
                        "contract_version": {
                          "type": "string"
                        },
                        "profile": {
                          "type": "string",
                          "const": "m2m_escrow_arbiter"
                        },
                        "arbitration_ruling": {
                          "type": "object",
                          "required": [
                            "status",
                            "ruling",
                            "score",
                            "escrow_id",
                            "payout_breakdown",
                            "checks",
                            "violations",
                            "evidence_gaps"
                          ],
                          "properties": {
                            "status": {
                              "type": "string",
                              "enum": [
                                "decision_ready",
                                "not_decision_ready",
                                "escalate"
                              ]
                            },
                            "ruling": {
                              "type": "string",
                              "enum": [
                                "RELEASE_TO_SELLER",
                                "REFUND_TO_BUYER",
                                "PARTIAL_SETTLEMENT",
                                "ESCALATE_HUMAN"
                              ]
                            },
                            "score": {
                              "type": "integer"
                            },
                            "escrow_id": {
                              "type": "string"
                            },
                            "payout_breakdown": {
                              "type": "object",
                              "required": [
                                "total_escrow_usd",
                                "seller_payout_usd",
                                "buyer_refund_usd",
                                "arbiter_fee_usd"
                              ],
                              "properties": {
                                "total_escrow_usd": {
                                  "type": "number"
                                },
                                "seller_payout_usd": {
                                  "type": "number"
                                },
                                "buyer_refund_usd": {
                                  "type": "number"
                                },
                                "arbiter_fee_usd": {
                                  "type": "number"
                                }
                              }
                            },
                            "checks": {
                              "type": "object",
                              "required": [
                                "deadline_honored",
                                "hash_verified",
                                "schema_verified",
                                "slo_verified"
                              ],
                              "properties": {
                                "deadline_honored": {
                                  "type": "boolean"
                                },
                                "hash_verified": {
                                  "type": "boolean"
                                },
                                "schema_verified": {
                                  "type": "boolean"
                                },
                                "slo_verified": {
                                  "type": "boolean"
                                }
                              }
                            },
                            "violations": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "evidence_gaps": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "vizier_status": {
                              "type": "string"
                            },
                            "vizier_clearance_receipt": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "execution_advisory": {
                              "type": "string"
                            },
                            "settlement_authorized": {
                              "type": "boolean",
                              "const": false
                            },
                            "evaluation_scope": {
                              "type": "string"
                            },
                            "check_status": {
                              "type": "object",
                              "additionalProperties": {
                                "enum": [
                                  "passed",
                                  "failed",
                                  "not_evaluated",
                                  "not_applicable"
                                ]
                              }
                            }
                          }
                        }
                      }
                    },
                    {
                      "type": "object",
                      "required": [
                        "id",
                        "status",
                        "artifacts",
                        "metadata"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "status": {
                          "type": "object",
                          "required": [
                            "state"
                          ],
                          "properties": {
                            "state": {
                              "type": "string"
                            }
                          }
                        },
                        "artifacts": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          }
                        },
                        "metadata": {
                          "type": "object",
                          "required": [
                            "response",
                            "human_review_required"
                          ],
                          "properties": {
                            "response": {
                              "$schema": "https://json-schema.org/draft/2020-12/schema",
                              "title": "M2MEscrowArbiterResponse",
                              "description": "Response contract for delivery-evidence review. Unverified delivery requires human review and cannot authorize settlement.",
                              "x-schema-version": "1",
                              "type": "object",
                              "additionalProperties": false,
                              "required": [
                                "contract_version",
                                "profile",
                                "arbitration_ruling"
                              ],
                              "properties": {
                                "contract_version": {
                                  "type": "string"
                                },
                                "profile": {
                                  "type": "string",
                                  "const": "m2m_escrow_arbiter"
                                },
                                "arbitration_ruling": {
                                  "type": "object",
                                  "required": [
                                    "status",
                                    "ruling",
                                    "score",
                                    "escrow_id",
                                    "payout_breakdown",
                                    "checks",
                                    "violations",
                                    "evidence_gaps"
                                  ],
                                  "properties": {
                                    "status": {
                                      "type": "string",
                                      "enum": [
                                        "decision_ready",
                                        "not_decision_ready",
                                        "escalate"
                                      ]
                                    },
                                    "ruling": {
                                      "type": "string",
                                      "enum": [
                                        "RELEASE_TO_SELLER",
                                        "REFUND_TO_BUYER",
                                        "PARTIAL_SETTLEMENT",
                                        "ESCALATE_HUMAN"
                                      ]
                                    },
                                    "score": {
                                      "type": "integer"
                                    },
                                    "escrow_id": {
                                      "type": "string"
                                    },
                                    "payout_breakdown": {
                                      "type": "object",
                                      "required": [
                                        "total_escrow_usd",
                                        "seller_payout_usd",
                                        "buyer_refund_usd",
                                        "arbiter_fee_usd"
                                      ],
                                      "properties": {
                                        "total_escrow_usd": {
                                          "type": "number"
                                        },
                                        "seller_payout_usd": {
                                          "type": "number"
                                        },
                                        "buyer_refund_usd": {
                                          "type": "number"
                                        },
                                        "arbiter_fee_usd": {
                                          "type": "number"
                                        }
                                      }
                                    },
                                    "checks": {
                                      "type": "object",
                                      "required": [
                                        "deadline_honored",
                                        "hash_verified",
                                        "schema_verified",
                                        "slo_verified"
                                      ],
                                      "properties": {
                                        "deadline_honored": {
                                          "type": "boolean"
                                        },
                                        "hash_verified": {
                                          "type": "boolean"
                                        },
                                        "schema_verified": {
                                          "type": "boolean"
                                        },
                                        "slo_verified": {
                                          "type": "boolean"
                                        }
                                      }
                                    },
                                    "violations": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "evidence_gaps": {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    "vizier_status": {
                                      "type": "string"
                                    },
                                    "vizier_clearance_receipt": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "execution_advisory": {
                                      "type": "string"
                                    },
                                    "settlement_authorized": {
                                      "type": "boolean",
                                      "const": false
                                    },
                                    "evaluation_scope": {
                                      "type": "string"
                                    },
                                    "check_status": {
                                      "type": "object",
                                      "additionalProperties": {
                                        "enum": [
                                          "passed",
                                          "failed",
                                          "not_evaluated",
                                          "not_applicable"
                                        ]
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "human_review_required": {
                              "const": true
                            }
                          }
                        }
                      }
                    }
                  ]
                },
                "annotations": {
                  "readOnlyHint": true,
                  "destructiveHint": false,
                  "idempotentHint": true,
                  "openWorldHint": false
                }
              }
            ]
          },
          "provider": {
            "legalEntity": {
              "type": "individual",
              "name": "Vassiliy Lakhonin",
              "sameAs": [
                "https://github.com/vassiliylakhonin",
                "https://pypi.org/project/agenda-intelligence-md/",
                "https://glama.ai/mcp/servers/vassiliylakhonin/agenda-intelligence-md"
              ]
            }
          }
        }
      }
    ]
  },
  "defaultInputModes": [
    "application/json",
    "text/plain",
    "text/markdown"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/markdown"
  ],
  "skills": [
    {
      "id": "m2m-escrow-arbitration-ruling",
      "name": "M2M escrow evidence review",
      "description": "Bring the delivery terms, expected and delivered hashes, timestamps and supplied SLO evidence. Get evidence findings and a proposed allocation for human review. Only a bounded offline JSON Schema subset is supported; no payout is executed or authorized. Evaluation requires structured JSON; see the request schema and A2A example in the card extension.",
      "tags": [
        "escrow",
        "m2m",
        "a2a",
        "dispute",
        "delivery-evidence",
        "human-review"
      ],
      "examples": [
        "Compare a delivered artifact hash with the agreed SHA-256 and flag a mismatch for review.",
        "Review deadline and supplied SLO evidence before a human decides an escrow allocation."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "signatures": [
    {
      "protected": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpPU0UiLCJqa3UiOiJodHRwczovL20ybS1lc2Nyb3ctYXJiaXRlci5hZ2VuZGFtY3AuZHBkbnMub3JnLy53ZWxsLWtub3duL2p3a3MuanNvbiIsImtpZCI6Im0ybS1lc2Nyb3ctYXJiaXRlci0xZmNjMTllYS01ZDdlLTQ0ZTEtYjY3Mi1iMjBlZDEzOTQ1ZTQifQ",
      "signature": "T_OVpJ8HUxAclLalVXSRIulq6dMFchToTkPUvZZVFx9tXTlp20TiM7bY0f055C668tkygoaT9VUmnm4WoPaQ-Q"
    }
  ]
}