RCO-A2A - Record of Cleared Orders
The signed receipt of one cleared decision, read by decision id: RCO, the Record of Cleared Orders
我该使用它吗
质量与安全性
发现(1)
- LOW在 write_receipt 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `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
}社区
证据