RCO-A2A - Record of Cleared Orders
The signed receipt of one cleared decision, read by decision id: RCO, the Record of Cleared Orders
¿Debería usar esto?
Calidad y seguridad
A
Hallazgos (1)
- LOWTool 'write_receipt' description lacks action verben write_receipt
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~1,707Tokens (definiciones de herramientas)
~8.6 KBTamaño de respuesta típico
Impacto moderado en la atención (1.33% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"rco-a2a": {
"url": "https://mcp.rco-a2a.ai/mcp"
}
}
}Puntos de conexión remotos
https://mcp.rco-a2a.ai/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (2)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.
Esquema de entrada
{
"type": "object",
"properties": {
"decision_id": {
"type": "string",
"pattern": "^(gate|dec)_[a-f0-9]{16,40}$"
}
},
"required": [
"decision_id"
]
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
]
}Esquema de salida
{
"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
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada2 herramientas