RCO-A2A - Record of Cleared Orders
The signed receipt of one cleared decision, read by decision id: RCO, the Record of Cleared Orders
使うべきか
品質と安全性
検出事項(1)
- LOWwrite_receipt 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"rco-a2a": {
"url": "https://mcp.rco-a2a.ai/mcp"
}
}
}リモートエンドポイント
https://mcp.rco-a2a.ai/mcpstreamable-httpできること
ツール一覧
ツール(2)
🟢get_receipt(decision_id)
RCO, the Record of Cleared Orders: the signed receipt of one cleared decision, by decision_id — what was cleared (a GTIN, an ISIN, a product id), for which actor class, under which rule and version, the records read, the signal, when, the issuing door, its signature and the ledger transaction id. Anyone, no account. No caller data, no PII, no amounts.
入力スキーマ
{
"type": "object",
"properties": {
"decision_id": {
"type": "string",
"pattern": "^(gate|dec)_[a-f0-9]{16,40}$"
}
},
"required": [
"decision_id"
]
}出力スキーマ
{
"type": "object",
"properties": {
"decision_id": {
"type": "string"
},
"hub": {
"type": "string",
"enum": [
"a2a-grocery",
"a2a-cosmetics",
"a2a-peptides"
]
},
"gtin": {
"type": "string",
"pattern": "^[0-9]{14}$"
},
"market": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"actor_class": {
"type": "string",
"description": "for which actor class (never a person)"
},
"result": {
"type": "string"
},
"reason_code": {
"type": "string"
},
"rule_set": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
]
}
}
},
"record": {
"type": [
"object",
"null"
],
"description": "the gtinfetch answer the decision read: source_page, fetch_date, status, kid",
"properties": {
"source_page": {
"type": [
"string",
"null"
]
},
"fetch_date": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"kid": {
"type": [
"string",
"null"
]
}
}
},
"decided_at": {
"type": "string"
},
"hub_signature": {
"type": [
"object",
"null"
],
"description": "the hub's detached JWS over the receipt (keys sorted, compact JSON), verified against the hub keyring",
"properties": {
"alg": {
"type": "string"
},
"kid": {
"type": "string"
},
"jws": {
"type": "string"
}
}
},
"object": {
"type": "object",
"required": [
"type",
"id"
],
"description": "what was cleared: a GTIN, an ISIN, a product id",
"properties": {
"type": {
"type": "string",
"enum": [
"isin",
"ticker",
"lei",
"cmr",
"gtin",
"product",
"identifier"
]
},
"id": {
"type": "string"
}
}
},
"rule": {
"type": "object",
"required": [
"id",
"version"
],
"description": "the rule object and version the decision was made under",
"properties": {
"id": {
"type": "string"
},
"version": {
"type": "string"
}
}
},
"records_read": {
"type": "array",
"description": "the records read, each with its signature (or null where the record carries none)",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"signature": {
"type": [
"object",
"null"
]
}
}
}
},
"signal": {
"type": "string",
"pattern": "^ACM-(000|200|300|403|404|451|500)$"
},
"issuing_door": {
"type": "string"
},
"signature": {
"type": "object",
"description": "the issuing door's detached JWS (EdDSA) over the receipt's canonical JSON (keys sorted, compact) without signature, signature_check, ledger, receipt_url, page",
"properties": {
"alg": {
"type": "string"
},
"kid": {
"type": "string"
},
"jws": {
"type": "string"
},
"keyring": {
"type": "string"
}
}
},
"ledger": {
"type": "object",
"properties": {
"host": {
"type": "string"
},
"transaction_id": {
"type": "string"
},
"hash": {
"type": "string"
}
}
}
},
"required": [
"decision_id",
"ledger"
],
"additionalProperties": true
}🟡write_receipt(receipt)
Authorised doors only: x-door-key (a key issued by the office; the door receipt of plan v1.1 §2.6, signed by the issuing door) or x-hub-key (a GSC hub gate receipt). The hash goes on the Confidential Ledger; the receipt is kept and served by decision_id. Idempotent on decision_id.
入力スキーマ
{
"type": "object",
"properties": {
"receipt": {
"type": "object",
"description": "a door receipt (dec_ id, x-door-key) or a hub receipt (gate_ id, x-hub-key)",
"anyOf": [
{
"type": "object",
"required": [
"decision_id",
"object",
"actor_class",
"rule",
"records_read",
"signal",
"decided_at",
"issuing_door",
"signature"
],
"properties": {
"decision_id": {
"type": "string",
"pattern": "^dec_[a-f0-9]{16,40}$",
"description": "the id the issuing door gave the decision"
},
"object": {
"type": "object",
"required": [
"type",
"id"
],
"description": "what was cleared: a GTIN, an ISIN, a product id",
"properties": {
"type": {
"type": "string",
"enum": [
"isin",
"ticker",
"lei",
"cmr",
"gtin",
"product",
"identifier"
]
},
"id": {
"type": "string"
}
}
},
"actor_class": {
"type": "string",
"description": "for which actor class (never a person)"
},
"rule": {
"type": "object",
"required": [
"id",
"version"
],
"description": "the rule object and version the decision was made under",
"properties": {
"id": {
"type": "string"
},
"version": {
"type": "string"
}
}
},
"records_read": {
"type": "array",
"description": "the records read, each with its signature (or null where the record carries none)",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"as_of": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": [
"string",
"null"
]
},
"signature": {
"type": [
"object",
"null"
]
}
}
}
},
"signal": {
"type": "string",
"pattern": "^ACM-(000|200|300|403|404|451|500)$"
},
"decided_at": {
"type": "string"
},
"issuing_door": {
"type": "string"
},
"signature": {
"type": "object",
"description": "the issuing door's detached JWS (EdDSA) over the receipt's canonical JSON (keys sorted, compact) without signature, signature_check, ledger, receipt_url, page",
"properties": {
"alg": {
"type": "string"
},
"kid": {
"type": "string"
},
"jws": {
"type": "string"
},
"keyring": {
"type": "string"
}
}
}
}
},
{
"type": "object",
"required": [
"decision_id",
"hub",
"gtin",
"market",
"actor_class",
"result",
"reason_code",
"rule_set",
"decided_at"
],
"properties": {
"decision_id": {
"type": "string",
"pattern": "^gate_[a-f0-9]{16,40}$",
"description": "the hub gate decision id"
},
"hub": {
"type": "string",
"enum": [
"a2a-grocery",
"a2a-cosmetics",
"a2a-peptides"
]
},
"gtin": {
"type": "string",
"pattern": "^[0-9]{14}$"
},
"market": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"actor_class": {
"type": "string"
},
"result": {
"type": "string"
},
"reason_code": {
"type": "string"
},
"rule_set": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"version": {
"type": [
"string",
"null"
]
}
}
},
"record": {
"type": [
"object",
"null"
],
"description": "the gtinfetch answer the decision read: source_page, fetch_date, status, kid",
"properties": {
"source_page": {
"type": [
"string",
"null"
]
},
"fetch_date": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"kid": {
"type": [
"string",
"null"
]
}
}
},
"decided_at": {
"type": "string"
},
"hub_signature": {
"type": [
"object",
"null"
],
"description": "the hub's detached JWS over the receipt (keys sorted, compact JSON), verified against the hub keyring",
"properties": {
"alg": {
"type": "string"
},
"kid": {
"type": "string"
},
"jws": {
"type": "string"
}
}
}
}
}
]
}
},
"required": [
"receipt"
]
}出力スキーマ
{
"type": "object",
"properties": {
"written": {
"type": "boolean"
},
"idempotent": {
"type": "boolean"
},
"decision_id": {
"type": "string"
},
"receipt_url": {
"type": "string"
},
"page": {
"type": "string"
},
"ledger": {
"type": "object"
}
},
"required": [
"written",
"decision_id",
"receipt_url",
"ledger"
],
"additionalProperties": true
}コミュニティ
エビデンス