Skip to main content
Glama

Get utility example

get_utility_example
Read-onlyIdempotent

Inspect a fixed synthetic request and expected result before integrating or paying. Select service from the enum; no caller document is accepted, processed or stored. Returns service and details containing that service's example. Free; no wallet authorization. Use get_utility_service_status for current readiness, prices and retention instead.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
serviceYesService whose fixed example or current terms to inspect.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added
  2. Removed
  3. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "example_version": {
      -            "const": "ardaro.agent-utilities.example.v1"
      -          },
      -          "policy": {
      -            "properties": {
      -              "financial_posting_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              },
      -              "payment_required": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "payment_required",
      -              "human_review_required",
      -              "financial_posting_supported"
      -            ],
      -            "type": "object"
      -          },
      -          "request": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "raw_conversation_history": {
      -                "description": "Caller-supplied text; do not submit secrets or private tenant data.",
      -                "maxLength": 32768,
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "raw_conversation_history"
      -            ],
      -            "type": "object"
      -          },
      -          "response": {
      -            "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"
      -                ],
      -                "type": "object"
      -              },
      -              "result": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "candidate_characters": {
      -                    "maximum": 32768,
      -                    "minimum": 1,
      -                    "type": "integer"
      -                  },
      -                  "characters_removed": {
      -                    "maximum": 32767,
      -                    "minimum": 0,
      -                    "type": "integer"
      -                  },
      -                  "compressed_prompt_payload": {
      -                    "maxLength": 32768,
      -                    "minLength": 1,
      -                    "type": "string"
      -                  },
      -                  "compression_ratio": {
      -                    "type": "null"
      -                  },
      -                  "human_review_required": {
      -                    "const": true,
      -                    "type": "boolean"
      -                  },
      -                  "latency_or_cost_savings_verified": {
      -                    "const": false,
      -                    "type": "boolean"
      -                  },
      -                  "original_characters": {
      -                    "maximum": 32768,
      -                    "minimum": 1,
      -                    "type": "integer"
      -                  },
      -                  "semantic_preservation_verified": {
      -                    "const": false,
      -                    "type": "boolean"
      -                  },
      -                  "status": {
      -                    "const": "REVIEW_CANDIDATE",
      -                    "type": "string"
      -                  },
      -                  "tokenizer_used": {
      -                    "type": "null"
      -                  },
      -                  "tokens_saved": {
      -                    "type": "null"
      -                  },
      -                  "transformation": {
      -                    "const": "Reduce three or more consecutive LF/CRLF line breaks to two LF line breaks; no words or role headers removed",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "status",
      -                  "compressed_prompt_payload",
      -                  "transformation",
      -                  "original_characters",
      -                  "candidate_characters",
      -                  "characters_removed",
      -                  "tokens_saved",
      -                  "tokenizer_used",
      -                  "compression_ratio",
      -                  "semantic_preservation_verified",
      -                  "human_review_required",
      -                  "latency_or_cost_savings_verified"
      -                ],
      -                "type": "object"
      -              },
      -              "service_id": {
      -                "const": "ardaro.compress_agent_context"
      -              },
      -              "status": {
      -                "const": "review_required"
      -              }
      -            },
      -            "required": [
      -              "contract_version",
      -              "service_id",
      -              "status",
      -              "result",
      -              "identities"
      -            ],
      -            "type": "object"
      -          },
      -          "service_id": {
      -            "const": "ardaro.compress_agent_context"
      -          },
      -          "synthetic_only": {
      -            "const": true
      -          }
      -        },
      -        "required": [
      -          "example_version",
      -          "service_id",
      -          "synthetic_only",
      -          "request",
      -          "response",
      -          "policy"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "compress_agent_context"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "example_version": {
      -            "const": "ardaro.agent-utilities.example.v1"
      -          },
      -          "policy": {
      -            "properties": {
      -              "financial_posting_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              },
      -              "payment_required": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "payment_required",
      -              "human_review_required",
      -              "financial_posting_supported"
      -            ],
      -            "type": "object"
      -          },
      -          "request": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "intent_payload": {
      -                "description": "Caller-supplied text; do not submit secrets or private tenant data.",
      -                "maxLength": 32768,
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "intent_payload"
      -            ],
      -            "type": "object"
      -          },
      -          "response": {
      -            "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"
      -                ],
      -                "type": "object"
      -              },
      -              "result": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "human_review_required": {
      -                    "const": true,
      -                    "type": "boolean"
      -                  },
      -                  "recommended_model": {
      -                    "type": "null"
      -                  },
      -                  "route_category": {
      -                    "enum": [
      -                      "structured-calculation-review",
      -                      "general-text-review"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "route_executed": {
      -                    "const": false,
      -                    "type": "boolean"
      -                  },
      -                  "routing_basis": {
      -                    "const": "Keyword heuristic only; no model capability, availability or price comparison",
      -                    "type": "string"
      -                  },
      -                  "status": {
      -                    "const": "ADVISORY_ROUTE",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "status",
      -                  "route_category",
      -                  "routing_basis",
      -                  "recommended_model",
      -                  "route_executed",
      -                  "human_review_required"
      -                ],
      -                "type": "object"
      -              },
      -              "service_id": {
      -                "const": "ardaro.route_model_intent"
      -              },
      -              "status": {
      -                "const": "review_required"
      -              }
      -            },
      -            "required": [
      -              "contract_version",
      -              "service_id",
      -              "status",
      -              "result",
      -              "identities"
      -            ],
      -            "type": "object"
      -          },
      -          "service_id": {
      -            "const": "ardaro.route_model_intent"
      -          },
      -          "synthetic_only": {
      -            "const": true
      -          }
      -        },
      -        "required": [
      -          "example_version",
      -          "service_id",
      -          "synthetic_only",
      -          "request",
      -          "response",
      -          "policy"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "route_model_intent"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "example_version": {
      -            "const": "ardaro.agent-utilities.example.v1"
      -          },
      -          "policy": {
      -            "properties": {
      -              "financial_posting_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              },
      -              "payment_required": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "payment_required",
      -              "human_review_required",
      -              "financial_posting_supported"
      -            ],
      -            "type": "object"
      -          },
      -          "request": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "currency": {
      -                "enum": [
      -                  "USD",
      -                  "USDC"
      -                ],
      -                "type": "string"
      -              },
      -              "history": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "checks_last_minute": {
      -                    "maximum": 1000000,
      -                    "minimum": 0,
      -                    "type": "integer"
      -                  },
      -                  "committed_last_hour": {
      -                    "maxLength": 16,
      -                    "minLength": 1,
      -                    "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])",
      -                    "type": "string"
      -                  },
      -                  "currency": {
      -                    "enum": [
      -                      "USD",
      -                      "USDC"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "pending_reserved": {
      -                    "maxLength": 16,
      -                    "minLength": 1,
      -                    "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "currency",
      -                  "committed_last_hour",
      -                  "pending_reserved",
      -                  "checks_last_minute"
      -                ],
      -                "type": "object"
      -              },
      -              "policy": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "currency": {
      -                    "enum": [
      -                      "USD",
      -                      "USDC"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "max_checks_per_minute": {
      -                    "maximum": 1000000,
      -                    "minimum": 1,
      -                    "type": "integer"
      -                  },
      -                  "max_per_hour": {
      -                    "maxLength": 16,
      -                    "minLength": 1,
      -                    "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])",
      -                    "type": "string"
      -                  },
      -                  "max_per_transaction": {
      -                    "maxLength": 16,
      -                    "minLength": 1,
      -                    "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "currency",
      -                  "max_per_transaction",
      -                  "max_per_hour",
      -                  "max_checks_per_minute"
      -                ],
      -                "type": "object"
      -              },
      -              "proposed_cost": {
      -                "maxLength": 16,
      -                "minLength": 1,
      -                "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "proposed_cost",
      -              "currency",
      -              "policy",
      -              "history"
      -            ],
      -            "type": "object"
      -          },
      -          "response": {
      -            "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"
      -                ],
      -                "type": "object"
      -              },
      -              "result": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "authorization_status": {
      -                    "enum": [
      -                      "WITHIN_SUBMITTED_LIMITS",
      -                      "EXCEEDS_SUBMITTED_LIMITS",
      -                      "RATE_THRESHOLD_EXCEEDED",
      -                      "CURRENCY_MISMATCH"
      -                    ]
      -                  },
      -                  "checks": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "currency_consistent": {
      -                        "type": "boolean"
      -                      },
      -                      "hourly_within_limit": {
      -                        "type": [
      -                          "boolean",
      -                          "null"
      -                        ]
      -                      },
      -                      "rate_within_limit": {
      -                        "type": "boolean"
      -                      },
      -                      "transaction_within_limit": {
      -                        "type": [
      -                          "boolean",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "currency_consistent",
      -                      "transaction_within_limit",
      -                      "hourly_within_limit",
      -                      "rate_within_limit"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "currency": {
      -                    "enum": [
      -                      "USD",
      -                      "USDC"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "findings": {
      -                    "items": {
      -                      "enum": [
      -                        "CURRENCY_MISMATCH",
      -                        "TRANSACTION_LIMIT_EXCEEDED",
      -                        "HOURLY_LIMIT_EXCEEDED",
      -                        "RATE_THRESHOLD_EXCEEDED"
      -                      ]
      -                    },
      -                    "maxItems": 3,
      -                    "type": "array",
      -                    "uniqueItems": true
      -                  },
      -                  "history_currency": {
      -                    "enum": [
      -                      "USD",
      -                      "USDC"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "hourly_remaining_after_proposal": {
      -                    "anyOf": [
      -                      {
      -                        "maxLength": 18,
      -                        "minLength": 8,
      -                        "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}(?![\\s\\S])",
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "policy": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "advisory_only": {
      -                        "const": true
      -                      },
      -                      "caller_identity_authenticated": {
      -                        "const": false
      -                      },
      -                      "checks_exclude_service_fee": {
      -                        "const": true
      -                      },
      -                      "credentials_issued": {
      -                        "const": false
      -                      },
      -                      "delivery_verified": {
      -                        "const": false
      -                      },
      -                      "downstream_payment_authorized": {
      -                        "const": false
      -                      },
      -                      "external_spend_enforced": {
      -                        "const": false
      -                      },
      -                      "fee_scope": {
      -                        "const": "The separately quoted service fee is excluded from these checks and must be budgeted separately in USDC. No USD/USDC conversion is performed."
      -                      },
      -                      "history_scope": {
      -                        "const": "The caller supplies committed cost for its intended rolling-hour window, all unresolved pending reservations, and the count of prior checks in its intended minute. Completeness and timing are not verified."
      -                      },
      -                      "history_verified": {
      -                        "const": false
      -                      },
      -                      "human_review_required": {
      -                        "const": true
      -                      },
      -                      "ledger_updated": {
      -                        "const": false
      -                      },
      -                      "model_calls": {
      -                        "const": 0
      -                      },
      -                      "policy_authenticated": {
      -                        "const": false
      -                      },
      -                      "reservation_created": {
      -                        "const": false
      -                      },
      -                      "scope": {
      -                        "const": "Compares caller-supplied downstream maximum cost with caller-supplied limits and history. A within-limits result is not authorization, a reservation, or evidence that actual spend is controlled."
      -                      },
      -                      "stateless": {
      -                        "const": true
      -                      },
      -                      "submitted_evidence_verified": {
      -                        "const": false
      -                      },
      -                      "submitted_records_retained": {
      -                        "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",
      -                      "policy_authenticated",
      -                      "history_verified",
      -                      "checks_exclude_service_fee",
      -                      "scope",
      -                      "fee_scope",
      -                      "history_scope"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "policy_currency": {
      -                    "enum": [
      -                      "USD",
      -                      "USDC"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "proposed_cost": {
      -                    "maxLength": 18,
      -                    "minLength": 8,
      -                    "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}(?![\\s\\S])",
      -                    "type": "string"
      -                  },
      -                  "proposed_hour_total": {
      -                    "anyOf": [
      -                      {
      -                        "maxLength": 18,
      -                        "minLength": 8,
      -                        "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}(?![\\s\\S])",
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "submitted_budget_in_use": {
      -                    "anyOf": [
      -                      {
      -                        "maxLength": 18,
      -                        "minLength": 8,
      -                        "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}(?![\\s\\S])",
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "tool": {
      -                    "const": "authorize_agent_spend"
      -                  }
      -                },
      -                "required": [
      -                  "tool",
      -                  "authorization_status",
      -                  "currency",
      -                  "policy_currency",
      -                  "history_currency",
      -                  "proposed_cost",
      -                  "submitted_budget_in_use",
      -                  "proposed_hour_total",
      -                  "hourly_remaining_after_proposal",
      -                  "checks",
      -                  "findings",
      -                  "policy"
      -                ],
      -                "type": "object"
      -              },
      -              "service_id": {
      -                "const": "ardaro.authorize_agent_spend"
      -              },
      -              "status": {
      -                "const": "review_required"
      -              }
      -            },
      -            "required": [
      -              "contract_version",
      -              "service_id",
      -              "status",
      -              "result",
      -              "identities"
      -            ],
      -            "type": "object"
      -          },
      -          "service_id": {
      -            "const": "ardaro.authorize_agent_spend"
      -          },
      -          "synthetic_only": {
      -            "const": true
      -          }
      -        },
      -        "required": [
      -          "example_version",
      -          "service_id",
      -          "synthetic_only",
      -          "request",
      -          "response",
      -          "policy"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "authorize_agent_spend"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "example_version": {
      -            "const": "ardaro.agent-utilities.example.v1"
      -          },
      -          "policy": {
      -            "properties": {
      -              "financial_posting_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              },
      -              "payment_required": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "payment_required",
      -              "human_review_required",
      -              "financial_posting_supported"
      -            ],
      -            "type": "object"
      -          },
      -          "request": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "billing_records": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "amount": {
      -                      "maxLength": 16,
      -                      "minLength": 1,
      -                      "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])",
      -                      "type": "string"
      -                    },
      -                    "currency": {
      -                      "enum": [
      -                        "USD",
      -                        "USDC"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "request_id": {
      -                      "maxLength": 128,
      -                      "minLength": 1,
      -                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}(?![\\s\\S])",
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "request_id",
      -                    "amount",
      -                    "currency"
      -                  ],
      -                  "type": "object"
      -                },
      -                "maxItems": 100,
      -                "type": "array"
      -              },
      -              "usage_records": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "amount": {
      -                      "maxLength": 16,
      -                      "minLength": 1,
      -                      "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?(?![\\s\\S])",
      -                      "type": "string"
      -                    },
      -                    "currency": {
      -                      "enum": [
      -                        "USD",
      -                        "USDC"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "request_id": {
      -                      "maxLength": 128,
      -                      "minLength": 1,
      -                      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}(?![\\s\\S])",
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "request_id",
      -                    "amount",
      -                    "currency"
      -                  ],
      -                  "type": "object"
      -                },
      -                "maxItems": 100,
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "billing_records",
      -              "usage_records"
      -            ],
      -            "type": "object"
      -          },
      -          "response": {
      -            "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"
      -                ],
      -                "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"
      -          },
      -          "service_id": {
      -            "const": "ardaro.reconcile_api_ledger"
      -          },
      -          "synthetic_only": {
      -            "const": true
      -          }
      -        },
      -        "required": [
      -          "example_version",
      -          "service_id",
      -          "synthetic_only",
      -          "request",
      -          "response",
      -          "policy"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "reconcile_api_ledger"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "example_version": {
      +            "const": "ardaro.agent-utilities.example.v1"
      +          },
      +          "policy": {
      +            "properties": {
      +              "financial_posting_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              },
      +              "payment_required": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "payment_required",
      +              "human_review_required",
      +              "financial_posting_supported"
      +            ],
      +            "type": "object"
      +          },
      +          "request": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "raw_conversation_history": {
      +                "description": "Caller-supplied text; do not submit secrets or private tenant data.",
      +                "maxLength": 32768,
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "raw_conversation_history"
      +            ],
      +            "type": "object"
      +          },
      +          "response": {
      +            "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"
      +                ],
      +                "type": "object"
      +              },
      +              "result": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "candidate_characters": {
      +                    "maximum": 32768,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "characters_removed": {
      +                    "maximum": 32767,
      +                    "minimum": 0,
      +                    "type": "integer"
      +                  },
      +                  "compressed_prompt_payload": {
      +                    "maxLength": 32768,
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "compression_ratio": {
      +                    "type": "null"
      +                  },
      +                  "human_review_required": {
      +                    "const": true,
      +                    "type": "boolean"
      +                  },
      +                  "latency_or_cost_savings_verified": {
      +                    "const": false,
      +                    "type": "boolean"
      +                  },
      +                  "original_characters": {
      +                    "maximum": 32768,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "semantic_preservation_verified": {
      +                    "const": false,
      +                    "type": "boolean"
      +                  },
      +                  "status": {
      +                    "const": "REVIEW_CANDIDATE",
      +                    "type": "string"
      +                  },
      +                  "tokenizer_used": {
      +                    "type": "null"
      +                  },
      +                  "tokens_saved": {
      +                    "type": "null"
      +                  },
      +                  "transformation": {
      +                    "const": "Reduce three or more consecutive LF/CRLF line breaks to two LF line breaks; no words or role headers removed",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "status",
      +                  "compressed_prompt_payload",
      +                  "transformation",
      +                  "original_characters",
      +                  "candidate_characters",
      +                  "characters_removed",
      +                  "tokens_saved",
      +                  "tokenizer_used",
      +                  "compression_ratio",
      +                  "semantic_preservation_verified",
      +                  "human_review_required",
      +                  "latency_or_cost_savings_verified"
      +                ],
      +                "type": "object"
      +              },
      +              "service_id": {
      +                "const": "ardaro.compress_agent_context"
      +              },
      +              "status": {
      +                "const": "review_required"
      +              }
      +            },
      +            "required": [
      +              "contract_version",
      +              "service_id",
      +              "status",
      +              "result",
      +              "identities"
      +            ],
      +            "type": "object"
      +          },
      +          "service_id": {
      +            "const": "ardaro.compress_agent_context"
      +          },
      +          "synthetic_only": {
      +            "const": true
      +          }
      +        },
      +        "required": [
      +          "example_version",
      +          "service_id",
      +          "synthetic_only",
      +          "request",
      +          "response",
      +          "policy"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "compress_agent_context"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "example_version": {
      +            "const": "ardaro.agent-utilities.example.v1"
      +          },
      +          "policy": {
      +            "properties": {
      +              "financial_posting_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              },
      +              "payment_required": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "payment_required",
      +              "human_review_required",
      +              "financial_posting_supported"
      +            ],
      +            "type": "object"
      +          },
      +          "request": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "intent_payload": {
      +                "description": "Caller-supplied text; do not submit secrets or private tenant data.",
      +                "maxLength": 32768,
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "intent_payload"
      +            ],
      +            "type": "object"
      +          },
      +          "response": {
      +            "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"
      +                ],
      +                "type": "object"
      +              },
      +              "result": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "human_review_required": {
      +                    "const": true,
      +                    "type": "boolean"
      +                  },
      +                  "recommended_model": {
      +                    "type": "null"
      +                  },
      +                  "route_category": {
      +                    "enum": [
      +                      "structured-calculation-review",
      +                      "general-text-review"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "route_executed": {
      +                    "const": false,
      +                    "type": "boolean"
      +                  },
      +                  "routing_basis": {
      +                    "const": "Keyword heuristic only; no model capability, availability or price comparison",
      +                    "type": "string"
      +                  },
      +                  "status": {
      +                    "const": "ADVISORY_ROUTE",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "status",
      +                  "route_category",
      +                  "routing_basis",
      +                  "recommended_model",
      +                  "route_executed",
      +                  "human_review_required"
      +                ],
      +                "type": "object"
      +              },
      +              "service_id": {
      +                "const": "ardaro.route_model_intent"
      +              },
      +              "status": {
      +                "const": "review_required"
      +              }
      +            },
      +            "required": [
      +              "contract_version",
      +              "service_id",
      +              "status",
      +              "result",
      +              "identities"
      +            ],
      +            "type": "object"
      +          },
      +          "service_id": {
      +            "const": "ardaro.route_model_intent"
      +          },
      +          "synthetic_only": {
      +            "const": true
      +          }
      +        },
      +        "required": [
      +          "example_version",
      +          "service_id",
      +          "synthetic_only",
      +          "request",
      +          "response",
      +          "policy"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "route_model_intent"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "example_version": {
      +            "const": "ardaro.agent-utilities.example.v1"
      +          },
      +          "policy": {
      +            "properties": {
      +              "financial_posting_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              },
      +              "payment_required": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "payment_required",
      +              "human_review_required",
      +              "financial_posting_supported"
      +            ],
      +            "type": "object"
      +          },
      +          "request": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "currency": {
      +                "enum": [
      +                  "USD",
      +                  "USDC"
      +                ],
      +                "type": "string"
      +              },
      +              "history": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "checks_last_minute": {
      +                    "maximum": 1000000,
      +                    "minimum": 0,
      +                    "type": "integer"
      +                  },
      +                  "committed_last_hour": {
      +                    "maxLength": 16,
      +                    "minLength": 1,
      +                    "not": {
      +                      "pattern": "\\n"
      +                    },
      +                    "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
      +                    "type": "string"
      +                  },
      +                  "currency": {
      +                    "enum": [
      +                      "USD",
      +                      "USDC"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "pending_reserved": {
      +                    "maxLength": 16,
      +                    "minLength": 1,
      +                    "not": {
      +                      "pattern": "\\n"
      +                    },
      +                    "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "currency",
      +                  "committed_last_hour",
      +                  "pending_reserved",
      +                  "checks_last_minute"
      +                ],
      +                "type": "object"
      +              },
      +              "policy": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "currency": {
      +                    "enum": [
      +                      "USD",
      +                      "USDC"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "max_checks_per_minute": {
      +                    "maximum": 1000000,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "max_per_hour": {
      +                    "maxLength": 16,
      +                    "minLength": 1,
      +                    "not": {
      +                      "pattern": "\\n"
      +                    },
      +                    "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
      +                    "type": "string"
      +                  },
      +                  "max_per_transaction": {
      +                    "maxLength": 16,
      +                    "minLength": 1,
      +                    "not": {
      +                      "pattern": "\\n"
      +                    },
      +                    "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "currency",
      +                  "max_per_transaction",
      +                  "max_per_hour",
      +                  "max_checks_per_minute"
      +                ],
      +                "type": "object"
      +              },
      +              "proposed_cost": {
      +                "maxLength": 16,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "proposed_cost",
      +              "currency",
      +              "policy",
      +              "history"
      +            ],
      +            "type": "object"
      +          },
      +          "response": {
      +            "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"
      +                ],
      +                "type": "object"
      +              },
      +              "result": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "authorization_status": {
      +                    "enum": [
      +                      "WITHIN_SUBMITTED_LIMITS",
      +                      "EXCEEDS_SUBMITTED_LIMITS",
      +                      "RATE_THRESHOLD_EXCEEDED",
      +                      "CURRENCY_MISMATCH"
      +                    ]
      +                  },
      +                  "checks": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "currency_consistent": {
      +                        "type": "boolean"
      +                      },
      +                      "hourly_within_limit": {
      +                        "type": [
      +                          "boolean",
      +                          "null"
      +                        ]
      +                      },
      +                      "rate_within_limit": {
      +                        "type": "boolean"
      +                      },
      +                      "transaction_within_limit": {
      +                        "type": [
      +                          "boolean",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "currency_consistent",
      +                      "transaction_within_limit",
      +                      "hourly_within_limit",
      +                      "rate_within_limit"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "currency": {
      +                    "enum": [
      +                      "USD",
      +                      "USDC"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "findings": {
      +                    "items": {
      +                      "enum": [
      +                        "CURRENCY_MISMATCH",
      +                        "TRANSACTION_LIMIT_EXCEEDED",
      +                        "HOURLY_LIMIT_EXCEEDED",
      +                        "RATE_THRESHOLD_EXCEEDED"
      +                      ]
      +                    },
      +                    "maxItems": 3,
      +                    "type": "array",
      +                    "uniqueItems": true
      +                  },
      +                  "history_currency": {
      +                    "enum": [
      +                      "USD",
      +                      "USDC"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "hourly_remaining_after_proposal": {
      +                    "anyOf": [
      +                      {
      +                        "maxLength": 18,
      +                        "minLength": 8,
      +                        "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$",
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "policy": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "advisory_only": {
      +                        "const": true
      +                      },
      +                      "caller_identity_authenticated": {
      +                        "const": false
      +                      },
      +                      "checks_exclude_service_fee": {
      +                        "const": true
      +                      },
      +                      "credentials_issued": {
      +                        "const": false
      +                      },
      +                      "delivery_verified": {
      +                        "const": false
      +                      },
      +                      "downstream_payment_authorized": {
      +                        "const": false
      +                      },
      +                      "external_spend_enforced": {
      +                        "const": false
      +                      },
      +                      "fee_scope": {
      +                        "const": "The separately quoted service fee is excluded from these checks and must be budgeted separately in USDC. No USD/USDC conversion is performed."
      +                      },
      +                      "history_scope": {
      +                        "const": "The caller supplies committed cost for its intended rolling-hour window, all unresolved pending reservations, and the count of prior checks in its intended minute. Completeness and timing are not verified."
      +                      },
      +                      "history_verified": {
      +                        "const": false
      +                      },
      +                      "human_review_required": {
      +                        "const": true
      +                      },
      +                      "ledger_updated": {
      +                        "const": false
      +                      },
      +                      "model_calls": {
      +                        "const": 0
      +                      },
      +                      "policy_authenticated": {
      +                        "const": false
      +                      },
      +                      "reservation_created": {
      +                        "const": false
      +                      },
      +                      "scope": {
      +                        "const": "Compares caller-supplied downstream maximum cost with caller-supplied limits and history. A within-limits result is not authorization, a reservation, or evidence that actual spend is controlled."
      +                      },
      +                      "stateless": {
      +                        "const": true
      +                      },
      +                      "submitted_evidence_verified": {
      +                        "const": false
      +                      },
      +                      "submitted_records_retained": {
      +                        "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",
      +                      "policy_authenticated",
      +                      "history_verified",
      +                      "checks_exclude_service_fee",
      +                      "scope",
      +                      "fee_scope",
      +                      "history_scope"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "policy_currency": {
      +                    "enum": [
      +                      "USD",
      +                      "USDC"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "proposed_cost": {
      +                    "maxLength": 18,
      +                    "minLength": 8,
      +                    "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$",
      +                    "type": "string"
      +                  },
      +                  "proposed_hour_total": {
      +                    "anyOf": [
      +                      {
      +                        "maxLength": 18,
      +                        "minLength": 8,
      +                        "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$",
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "submitted_budget_in_use": {
      +                    "anyOf": [
      +                      {
      +                        "maxLength": 18,
      +                        "minLength": 8,
      +                        "pattern": "^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$",
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "tool": {
      +                    "const": "authorize_agent_spend"
      +                  }
      +                },
      +                "required": [
      +                  "tool",
      +                  "authorization_status",
      +                  "currency",
      +                  "policy_currency",
      +                  "history_currency",
      +                  "proposed_cost",
      +                  "submitted_budget_in_use",
      +                  "proposed_hour_total",
      +                  "hourly_remaining_after_proposal",
      +                  "checks",
      +                  "findings",
      +                  "policy"
      +                ],
      +                "type": "object"
      +              },
      +              "service_id": {
      +                "const": "ardaro.authorize_agent_spend"
      +              },
      +              "status": {
      +                "const": "review_required"
      +              }
      +            },
      +            "required": [
      +              "contract_version",
      +              "service_id",
      +              "status",
      +              "result",
      +              "identities"
      +            ],
      +            "type": "object"
      +          },
      +          "service_id": {
      +            "const": "ardaro.authorize_agent_spend"
      +          },
      +          "synthetic_only": {
      +            "const": true
      +          }
      +        },
      +        "required": [
      +          "example_version",
      +          "service_id",
      +          "synthetic_only",
      +          "request",
      +          "response",
      +          "policy"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "authorize_agent_spend"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "example_version": {
      +            "const": "ardaro.agent-utilities.example.v1"
      +          },
      +          "policy": {
      +            "properties": {
      +              "financial_posting_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              },
      +              "payment_required": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "payment_required",
      +              "human_review_required",
      +              "financial_posting_supported"
      +            ],
      +            "type": "object"
      +          },
      +          "request": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "billing_records": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "amount": {
      +                      "maxLength": 16,
      +                      "minLength": 1,
      +                      "not": {
      +                        "pattern": "\\n"
      +                      },
      +                      "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
      +                      "type": "string"
      +                    },
      +                    "currency": {
      +                      "enum": [
      +                        "USD",
      +                        "USDC"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "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",
      +                    "amount",
      +                    "currency"
      +                  ],
      +                  "type": "object"
      +                },
      +                "maxItems": 100,
      +                "type": "array"
      +              },
      +              "usage_records": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "amount": {
      +                      "maxLength": 16,
      +                      "minLength": 1,
      +                      "not": {
      +                        "pattern": "\\n"
      +                      },
      +                      "pattern": "^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$",
      +                      "type": "string"
      +                    },
      +                    "currency": {
      +                      "enum": [
      +                        "USD",
      +                        "USDC"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "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",
      +                    "amount",
      +                    "currency"
      +                  ],
      +                  "type": "object"
      +                },
      +                "maxItems": 100,
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "billing_records",
      +              "usage_records"
      +            ],
      +            "type": "object"
      +          },
      +          "response": {
      +            "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"
      +                ],
      +                "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"
      +          },
      +          "service_id": {
      +            "const": "ardaro.reconcile_api_ledger"
      +          },
      +          "synthetic_only": {
      +            "const": true
      +          }
      +        },
      +        "required": [
      +          "example_version",
      +          "service_id",
      +          "synthetic_only",
      +          "request",
      +          "response",
      +          "policy"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "reconcile_api_ledger"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Annotations already cover read-only, idempotent, non-destructive safety. The description adds valuable behavioral context beyond annotations: it returns a fixed synthetic example, does not accept/process/store caller documents, is free, and requires no wallet authorization.

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?

Four short sentences, each earning its place: purpose, selection instruction, behavioral guarantee, and routing to the alternative. Front-loaded with the core purpose.

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?

Given a single required enum parameter, rich annotations, and an output schema, the description covers purpose, constraints, cost/auth, data handling, and the relevant sibling tool. Nothing needed for correct invocation is missing.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents the single 'service' parameter. The description confirms to select from the enum but adds no meaning beyond the schema. Baseline 3 is appropriate.

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 clearly states a specific action ('Inspect a fixed synthetic request and expected result') and a specific resource (utility example). It also distinguishes itself from the sibling get_utility_service_status by explicitly deferring readiness, prices, and retention to that tool.

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?

It tells the agent when to use this tool ('before integrating or paying'), what to do ('Select service from the enum'), what not to do ('no caller document is accepted'), and explicitly names the alternative for current readiness, prices, and retention. No inference is required.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources