Ardaro Agent Runtime Utilities

Submitted billing reconciliation

reconcile_api_ledger

Read-onlyIdempotent

Compare supplied billing and usage records by request ID, exact amount and currency. Flags missing or mismatched records. Does not authenticate telemetry, verify delivery or post to accounting. Paid: 0.25 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='reconcile_api_ledger' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`usage_records`	Yes
`billing_records`	Yes

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

AddedSep 17, 2026
RemovedSep 15, 2026

Changed9 schema fields changedSep 15, 2026

addedInput schema / properties / billing_records / items / properties / amount / not
```
Added value: +{
+  "pattern": "\\n"
+}
```

changedInput schema / properties / billing_records / items / properties / amount / pattern

Previous value: -"^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])"New value: +"^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$"

addedInput schema / properties / billing_records / items / properties / request_id / not
```
Added value: +{
+  "pattern": "\\n"
+}
```

changedInput schema / properties / billing_records / items / properties / request_id / pattern

Previous value: -"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}(?![\\s\\S])"New value: +"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"

addedInput schema / properties / usage_records / items / properties / amount / not
```
Added value: +{
+  "pattern": "\\n"
+}
```

changedInput schema / properties / usage_records / items / properties / amount / pattern

Previous value: -"^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])"New value: +"^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$"

addedInput schema / properties / usage_records / items / properties / request_id / not
```
Added value: +{
+  "pattern": "\\n"
+}
```

changedInput schema / properties / usage_records / items / properties / request_id / pattern

Previous value: -"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}(?![\\s\\S])"New value: +"^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$"

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contract_version": {
-        "const": "ardaro.agent-utilities.response.v1"
-      },
-      "identities": {
-        "additionalProperties": false,
-        "properties": {
-          "analysis_result_identity": {
-            "pattern": "^res_[0-9a-f]{64}(?![\\s\\S])",
-            "type": "string"
-          },
-          "payment_identity": {
-            "additionalProperties": false,
-            "properties": {
-              "protocol": {
-                "const": "x402-v2"
-              },
-              "reference": {
-                "pattern": "^pay_[0-9a-f]{64}(?![\\s\\S])",
-                "type": "string"
-              },
-              "replayed": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "protocol",
-              "reference",
-              "replayed"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "analysis_result_identity",
-          "payment_identity"
-        ],
-        "type": "object"
-      },
-      "result": {
-        "additionalProperties": false,
-        "properties": {
-          "issues": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "codes": {
-                  "items": {
-                    "enum": [
-                      "MISSING_BILLING_RECORD",
-                      "MISSING_USAGE_RECORD",
-                      "CURRENCY_MISMATCH",
-                      "AMOUNT_MISMATCH"
-                    ]
-                  },
-                  "maxItems": 1,
-                  "minItems": 1,
-                  "type": "array"
-                },
-                "request_id": {
-                  "maxLength": 128,
-                  "minLength": 1,
-                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}(?![\\s\\S])",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "request_id",
-                "codes"
-              ],
-              "type": "object"
-            },
-            "maxItems": 200,
-            "type": "array"
-          },
-          "matched_record_count": {
-            "maximum": 100,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "policy": {
-            "additionalProperties": false,
-            "properties": {
-              "advisory_only": {
-                "const": true
-              },
-              "caller_identity_authenticated": {
-                "const": false
-              },
-              "credentials_issued": {
-                "const": false
-              },
-              "delivery_verified": {
-                "const": false
-              },
-              "downstream_payment_authorized": {
-                "const": false
-              },
-              "external_spend_enforced": {
-                "const": false
-              },
-              "human_review_required": {
-                "const": true
-              },
-              "ledger_updated": {
-                "const": false
-              },
-              "model_calls": {
-                "const": 0
-              },
-              "reservation_created": {
-                "const": false
-              },
-              "scope": {
-                "const": "Compares caller-supplied billing and usage observations only. Matching records may both be inaccurate or incomplete. No reservation database, authenticated provider receipt, network packet, delivery, or blockchain record is inspected."
-              },
-              "stateless": {
-                "const": true
-              },
-              "submitted_evidence_verified": {
-                "const": false
-              },
-              "submitted_records_retained": {
-                "const": false
-              },
-              "telemetry_independently_verified": {
-                "const": false
-              }
-            },
-            "required": [
-              "advisory_only",
-              "stateless",
-              "submitted_records_retained",
-              "caller_identity_authenticated",
-              "submitted_evidence_verified",
-              "external_spend_enforced",
-              "downstream_payment_authorized",
-              "reservation_created",
-              "ledger_updated",
-              "credentials_issued",
-              "delivery_verified",
-              "model_calls",
-              "human_review_required",
-              "telemetry_independently_verified",
-              "scope"
-            ],
-            "type": "object"
-          },
-          "reconciliation_status": {
-            "enum": [
-              "NO_RECORDS",
-              "MATCHED_SUBMITTED_RECORDS",
-              "DISCREPANCIES_FOUND"
-            ]
-          },
-          "records_compared": {
-            "maximum": 200,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "tool": {
-            "const": "reconcile_api_ledger"
-          },
-          "totals_by_currency": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "billing_count": {
-                  "maximum": 100,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "billing_total": {
-                  "maxLength": 18,
-                  "minLength": 8,
-                  "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}(?![\\s\\S])",
-                  "type": "string"
-                },
-                "currency": {
-                  "enum": [
-                    "USD",
-                    "USDC"
-                  ],
-                  "type": "string"
-                },
-                "usage_count": {
-                  "maximum": 100,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "usage_total": {
-                  "maxLength": 18,
-                  "minLength": 8,
-                  "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}(?![\\s\\S])",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "currency",
-                "billing_total",
-                "usage_total",
-                "billing_count",
-                "usage_count"
-              ],
-              "type": "object"
-            },
-            "maxItems": 2,
-            "type": "array"
-          }
-        },
-        "required": [
-          "tool",
-          "reconciliation_status",
-          "records_compared",
-          "matched_record_count",
-          "issues",
-          "totals_by_currency",
-          "policy"
-        ],
-        "type": "object"
-      },
-      "service_id": {
-        "const": "ardaro.reconcile_api_ledger"
-      },
-      "status": {
-        "const": "review_required"
-      }
-    },
-    "required": [
-      "contract_version",
-      "service_id",
-      "status",
-      "result",
-      "identities"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contract_version": {
-        "const": "ardaro.agent-utilities.response.v1"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "maxLength": 100,
-            "type": "string"
-          },
-          "message": {
-            "maxLength": 300,
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "error"
-      }
-    },
-    "required": [
-      "contract_version",
-      "status",
-      "error"
-    ],
-    "type": "object"
-  },
-  {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "additionalProperties": false,
-    "properties": {
-      "contract_version": {
-        "const": "ardaro.agent-receipt-intelligence.response.v1"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "maxLength": 80,
-            "type": "string"
-          },
-          "message": {
-            "maxLength": 280,
-            "type": "string"
-          },
-          "remediation": {
-            "maxLength": 280,
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          },
-          "service_code": {
-            "enum": [
-              "ARDARO_ARITHMETIC_MISMATCH",
-              "ARDARO_DOCUMENT_TOO_LARGE",
-              "ARDARO_DUPLICATE_SUSPECTED",
-              "ARDARO_EXTRACTION_LOW_CONFIDENCE",
-              "ARDARO_IDEMPOTENCY_CONFLICT",
-              "ARDARO_INPUT_UNSUPPORTED",
-              "ARDARO_PAYMENT_INVALID",
-              "ARDARO_PAYMENT_RECONCILIATION_REQUIRED",
-              "ARDARO_PAYMENT_REQUIRED",
-              "ARDARO_RATE_LIMITED",
-              "ARDARO_SERVICE_UNAVAILABLE"
-            ]
-          }
-        },
-        "required": [
-          "code",
-          "service_code",
-          "message",
-          "retryable",
-          "remediation"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "error"
-      }
-    },
-    "required": [
-      "contract_version",
-      "status",
-      "error"
-    ],
-    "type": "object"
-  },
-  {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "additionalProperties": false,
-    "properties": {
-      "contract_version": {
-        "const": "ardaro.agent-receipt-intelligence.response.v1"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "maxLength": 80,
-            "minLength": 1,
-            "type": "string"
-          },
-          "message": {
-            "const": "Service is not ready."
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "service": {
-        "const": "ardaro-receipt-intelligence"
-      },
-      "status": {
-        "const": "not_ready"
-      }
-    },
-    "required": [
-      "contract_version",
-      "status",
-      "service",
-      "error"
-    ],
-    "type": "object"
-  },
-  {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "properties": {
-      "accepts": {
-        "items": {
-          "properties": {
-            "amount": {
-              "type": "string"
-            },
-            "asset": {
-              "type": "string"
-            },
-            "extra": {
-              "additionalProperties": true,
-              "type": "object"
-            },
-            "maxTimeoutSeconds": {
-              "type": "integer"
-            },
-            "network": {
-              "type": "string"
-            },
-            "payTo": {
-              "type": "string"
-            },
-            "scheme": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "scheme",
-            "network",
-            "asset",
-            "amount",
-            "payTo",
-            "maxTimeoutSeconds"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "error": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "extensions": {
-        "oneOf": [
-          {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "resource": {
-        "oneOf": [
-          {
-            "properties": {
-              "description": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "iconUrl": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "mimeType": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "serviceName": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "tags": {
-                "oneOf": [
-                  {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "url": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "url"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "x402Version": {
-        "const": 2,
-        "default": 2,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "accepts"
-    ],
-    "type": "object"
-  },
-  {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "message": {
-        "type": "string"
-      },
-      "status": {
-        "const": "error"
-      }
-    },
-    "required": [
-      "status",
-      "message"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contract_version": {
+        "const": "ardaro.agent-utilities.response.v1"
+      },
+      "identities": {
+        "additionalProperties": false,
+        "properties": {
+          "analysis_result_identity": {
+            "pattern": "^res_[0-9a-f]{64}$",
+            "type": "string"
+          },
+          "payment_identity": {
+            "additionalProperties": false,
+            "properties": {
+              "protocol": {
+                "const": "x402-v2"
+              },
+              "reference": {
+                "pattern": "^pay_[0-9a-f]{64}$",
+                "type": "string"
+              },
+              "replayed": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "protocol",
+              "reference",
+              "replayed"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "analysis_result_identity",
+          "payment_identity"
+        ],
+        "type": "object"
+      },
+      "result": {
+        "additionalProperties": false,
+        "properties": {
+          "issues": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "codes": {
+                  "items": {
+                    "enum": [
+                      "MISSING_BILLING_RECORD",
+                      "MISSING_USAGE_RECORD",
+                      "CURRENCY_MISMATCH",
+                      "AMOUNT_MISMATCH"
+                    ]
+                  },
+                  "maxItems": 1,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                "request_id": {
+                  "maxLength": 128,
+                  "minLength": 1,
+                  "not": {
+                    "pattern": "\\n"
+                  },
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "request_id",
+                "codes"
+              ],
+              "type": "object"
+            },
+            "maxItems": 200,
+            "type": "array"
+          },
+          "matched_record_count": {
+            "maximum": 100,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "policy": {
+            "additionalProperties": false,
+            "properties": {
+              "advisory_only": {
+                "const": true
+              },
+              "caller_identity_authenticated": {
+                "const": false
+              },
+              "credentials_issued": {
+                "const": false
+              },
+              "delivery_verified": {
+                "const": false
+              },
+              "downstream_payment_authorized": {
+                "const": false
+              },
+              "external_spend_enforced": {
+                "const": false
+              },
+              "human_review_required": {
+                "const": true
+              },
+              "ledger_updated": {
+                "const": false
+              },
+              "model_calls": {
+                "const": 0
+              },
+              "reservation_created": {
+                "const": false
+              },
+              "scope": {
+                "const": "Compares caller-supplied billing and usage observations only. Matching records may both be inaccurate or incomplete. No reservation database, authenticated provider receipt, network packet, delivery, or blockchain record is inspected."
+              },
+              "stateless": {
+                "const": true
+              },
+              "submitted_evidence_verified": {
+                "const": false
+              },
+              "submitted_records_retained": {
+                "const": false
+              },
+              "telemetry_independently_verified": {
+                "const": false
+              }
+            },
+            "required": [
+              "advisory_only",
+              "stateless",
+              "submitted_records_retained",
+              "caller_identity_authenticated",
+              "submitted_evidence_verified",
+              "external_spend_enforced",
+              "downstream_payment_authorized",
+              "reservation_created",
+              "ledger_updated",
+              "credentials_issued",
+              "delivery_verified",
+              "model_calls",
+              "human_review_required",
+              "telemetry_independently_verified",
+              "scope"
+            ],
+            "type": "object"
+          },
+          "reconciliation_status": {
+            "enum": [
+              "NO_RECORDS",
+              "MATCHED_SUBMITTED_RECORDS",
+              "DISCREPANCIES_FOUND"
+            ]
+          },
+          "records_compared": {
+            "maximum": 200,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "tool": {
+            "const": "reconcile_api_ledger"
+          },
+          "totals_by_currency": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "billing_count": {
+                  "maximum": 100,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "billing_total": {
+                  "maxLength": 18,
+                  "minLength": 8,
+                  "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$",
+                  "type": "string"
+                },
+                "currency": {
+                  "enum": [
+                    "USD",
+                    "USDC"
+                  ],
+                  "type": "string"
+                },
+                "usage_count": {
+                  "maximum": 100,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "usage_total": {
+                  "maxLength": 18,
+                  "minLength": 8,
+                  "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "currency",
+                "billing_total",
+                "usage_total",
+                "billing_count",
+                "usage_count"
+              ],
+              "type": "object"
+            },
+            "maxItems": 2,
+            "type": "array"
+          }
+        },
+        "required": [
+          "tool",
+          "reconciliation_status",
+          "records_compared",
+          "matched_record_count",
+          "issues",
+          "totals_by_currency",
+          "policy"
+        ],
+        "type": "object"
+      },
+      "service_id": {
+        "const": "ardaro.reconcile_api_ledger"
+      },
+      "status": {
+        "const": "review_required"
+      }
+    },
+    "required": [
+      "contract_version",
+      "service_id",
+      "status",
+      "result",
+      "identities"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contract_version": {
+        "const": "ardaro.agent-utilities.response.v1"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "maxLength": 100,
+            "type": "string"
+          },
+          "message": {
+            "maxLength": 300,
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "error"
+      }
+    },
+    "required": [
+      "contract_version",
+      "status",
+      "error"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "additionalProperties": false,
+    "properties": {
+      "contract_version": {
+        "const": "ardaro.agent-receipt-intelligence.response.v1"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "maxLength": 80,
+            "type": "string"
+          },
+          "message": {
+            "maxLength": 280,
+            "type": "string"
+          },
+          "remediation": {
+            "maxLength": 280,
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          },
+          "service_code": {
+            "enum": [
+              "ARDARO_ARITHMETIC_MISMATCH",
+              "ARDARO_DOCUMENT_TOO_LARGE",
+              "ARDARO_DUPLICATE_SUSPECTED",
+              "ARDARO_EXTRACTION_LOW_CONFIDENCE",
+              "ARDARO_IDEMPOTENCY_CONFLICT",
+              "ARDARO_INPUT_UNSUPPORTED",
+              "ARDARO_PAYMENT_INVALID",
+              "ARDARO_PAYMENT_RECONCILIATION_REQUIRED",
+              "ARDARO_PAYMENT_REQUIRED",
+              "ARDARO_RATE_LIMITED",
+              "ARDARO_SERVICE_UNAVAILABLE"
+            ]
+          }
+        },
+        "required": [
+          "code",
+          "service_code",
+          "message",
+          "retryable",
+          "remediation"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "error"
+      }
+    },
+    "required": [
+      "contract_version",
+      "status",
+      "error"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "additionalProperties": false,
+    "properties": {
+      "contract_version": {
+        "const": "ardaro.agent-receipt-intelligence.response.v1"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "maxLength": 80,
+            "minLength": 1,
+            "type": "string"
+          },
+          "message": {
+            "const": "Service is not ready."
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "service": {
+        "const": "ardaro-receipt-intelligence"
+      },
+      "status": {
+        "const": "not_ready"
+      }
+    },
+    "required": [
+      "contract_version",
+      "status",
+      "service",
+      "error"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "properties": {
+      "accepts": {
+        "items": {
+          "properties": {
+            "amount": {
+              "type": "string"
+            },
+            "asset": {
+              "type": "string"
+            },
+            "extra": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "maxTimeoutSeconds": {
+              "type": "integer"
+            },
+            "network": {
+              "type": "string"
+            },
+            "payTo": {
+              "type": "string"
+            },
+            "scheme": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "scheme",
+            "network",
+            "asset",
+            "amount",
+            "payTo",
+            "maxTimeoutSeconds"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "error": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "extensions": {
+        "oneOf": [
+          {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "resource": {
+        "oneOf": [
+          {
+            "properties": {
+              "description": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "iconUrl": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "mimeType": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "serviceName": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "tags": {
+                "oneOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "url": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "url"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "x402Version": {
+        "const": 2,
+        "default": 2,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "accepts"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "message": {
+        "type": "string"
+      },
+      "status": {
+        "const": "error"
+      }
+    },
+    "required": [
+      "status",
+      "message"
+    ],
+    "type": "object"
+  }
+]

First observedSep 14, 2026

TDQS

A4.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the agent knows it's safe and idempotent. The description adds key context: it is a paid service (0.25 USDC per accepted analysis), does not post to accounting, and requires owner-authorized x402 payment. This is valuable behavioral disclosure beyond the annotations, but it does not contradict them; the description's 'paid' aspect could be interpreted as a potential side-effect (spending) but is consistent with idempotency (no state change on the data).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise (about 3 sentences) and front-loads the core purpose and scope in the first sentence. It then adds usage guidance and payment terms without fluff. Every sentence carries meaningful information: purpose, limitations, cost, precheck, and authorization. No redundancy or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is moderately complex (Paid, requires authorization, has a precheck sibling), and the description covers all necessary aspects: purpose, limitations, cost, precheck, and authorization. The output schema exists (has output schema: true), so return format is not needed. The description is complete enough for an agent to call correctly, especially with the precheck step.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, meaning the description does not explain parameters individually. However, the tool name and description context clearly imply the two parameters: billing_records and usage_records, both being arrays of records with request_id, amount, and currency. The description says 'Compare supplied billing and usage records,' which directly maps to the parameters. The schema itself provides rich constraints (patterns, enums), so the description adds enough meaning to select and invoke correctly.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a clear purpose: 'Compare supplied billing and usage records by request ID, exact amount and currency.' It also explicitly states what the tool does not do ('Does not authenticate telemetry, verify delivery or post to accounting'), which distinguishes it from potential related tools. The sibling tools are mostly unrelated (e.g., authorize_agent_spend, get_utility_service_status), so no confusion, but the negative scope is helpful.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit guidance: 'Check get_utility_service_status with service='reconcile_api_ledger' and the free fixed example first.' It also mentions the paid nature and the need for owner authorization, clearly instructing the agent on proper usage before invoking the tool. This exceeds mere context, providing actionable steps.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Ardaro Agent Runtime Utilities tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?