Skip to main content
Glama

Ardaro Purchase Document Review

Get document readiness and terms

get_document_service_status
Read-onlyIdempotent

Check the selected service's current runtime readiness, input limits, pricing and retention before use. Returns service and details; ready=false means the underlying service is unavailable. Free cached runtime read; no external probe, payment, analysis or historical document retrieval. Use get_document_example for a fixed integration sample instead.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
serviceYesreceipt: extraction checks; invoice: paid invoice-to-PO quantity allocation; reconciliation: free three-document discrepancy checks without allocation. Choose one service; examples do not process caller documents.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / service / description
      Previous value: -"receipt: extraction checks. Examples do not process caller documents."New value: +"receipt: extraction checks; invoice: paid invoice-to-PO quantity allocation; reconciliation: free three-document discrepancy checks without allocation. Choose one service; examples do not process caller documents."
    • changedInput schema / properties / service / enum
      Previous value: -[
      -  "receipt"
      -]New value: +[
      +  "receipt",
      +  "invoice",
      +  "reconciliation"
      +]
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "$schema": "https://json-schema.org/draft/2020-12/schema",
      -        "additionalProperties": false,
      -        "properties": {
      -          "availability": {
      -            "additionalProperties": false,
      -            "description": "Cached runtime readiness, not a fresh external probe or settlement proof.",
      -            "properties": {
      -              "ready": {
      -                "description": "Whether the launch gate and cached dependencies currently allow paid processing.",
      -                "type": "boolean"
      -              },
      -              "reason": {
      -                "description": "Coarse public readiness reason; contains no internal error details.",
      -                "enum": [
      -                  "ready",
      -                  "launch_gate_closed",
      -                  "dependency_unavailable",
      -                  "not_configured"
      -                ]
      -              },
      -              "source": {
      -                "const": "cached_runtime_readiness"
      -              }
      -            },
      -            "required": [
      -              "ready",
      -              "reason",
      -              "source"
      -            ],
      -            "type": "object"
      -          },
      -          "limits": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "max_existing_fingerprints": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_line_items": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_pages": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_request_bytes": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_text_characters": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "normal_latency_target_ms": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "request_timeout_ms": {
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "max_existing_fingerprints",
      -              "max_line_items",
      -              "max_pages",
      -              "max_request_bytes",
      -              "max_text_characters",
      -              "normal_latency_target_ms",
      -              "request_timeout_ms"
      -            ],
      -            "type": "object"
      -          },
      -          "paid_processing_performed": {
      -            "const": false
      -          },
      -          "payment_authorized": {
      -            "const": false
      -          },
      -          "policy": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "advisory_only": {
      -                "const": true
      -              },
      -              "ardaro_saas_tenant_access": {
      -                "const": false
      -              },
      -              "financial_mutation_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              }
      -            },
      -            "required": [
      -              "advisory_only",
      -              "human_review_required",
      -              "financial_mutation_supported",
      -              "ardaro_saas_tenant_access"
      -            ],
      -            "type": "object"
      -          },
      -          "price": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "amount": {
      -                "pattern": "^[0-9]+\\.[0-9]{2}$",
      -                "type": "string"
      -              },
      -              "currency": {
      -                "const": "USDC"
      -              },
      -              "display": {
      -                "pattern": "^\\$[0-9]+\\.[0-9]{2}$",
      -                "type": "string"
      -              },
      -              "failed_input_validation_charged": {
      -                "const": false
      -              },
      -              "model": {
      -                "const": "fixed_per_accepted_request"
      -              },
      -              "network": {
      -                "type": "string"
      -              },
      -              "same_payment_identifier_replay_requires_new_payment": {
      -                "const": false
      -              },
      -              "successful_response_loss_retry_policy": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "model",
      -              "amount",
      -              "currency",
      -              "display",
      -              "network",
      -              "failed_input_validation_charged",
      -              "same_payment_identifier_replay_requires_new_payment",
      -              "successful_response_loss_retry_policy"
      -            ],
      -            "type": "object"
      -          },
      -          "retention": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "default_retention_seconds": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "deletion_behavior": {
      -                "type": "string"
      -              },
      -              "durable_recovery_supported": {
      -                "type": "boolean"
      -              },
      -              "extracted_results_retained": {
      -                "type": "boolean"
      -              },
      -              "payment_metadata_retention_seconds": {
      -                "minimum": 86400,
      -                "type": "integer"
      -              },
      -              "raw_documents_retained": {
      -                "const": false
      -              },
      -              "raw_receipt_images_retained": {
      -                "const": false
      -              },
      -              "storage_scope": {
      -                "type": "string"
      -              },
      -              "used_for_model_training": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "default_retention_seconds",
      -              "deletion_behavior",
      -              "durable_recovery_supported",
      -              "extracted_results_retained",
      -              "payment_metadata_retention_seconds",
      -              "raw_documents_retained",
      -              "raw_receipt_images_retained",
      -              "storage_scope",
      -              "used_for_model_training"
      -            ],
      -            "type": "object"
      -          },
      -          "service_id": {
      -            "const": "ardaro.receipt_intelligence"
      -          },
      -          "status_version": {
      -            "const": "ardaro.receipt-intelligence.service-status.v1"
      -          },
      -          "supported_input_types": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "description": {
      -                  "type": "string"
      -                },
      -                "input_kind": {
      -                  "enum": [
      -                    "text",
      -                    "structured"
      -                  ]
      -                },
      -                "mime_type": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "mime_type",
      -                "input_kind",
      -                "description"
      -              ],
      -              "type": "object"
      -            },
      -            "minItems": 1,
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "availability",
      -          "limits",
      -          "paid_processing_performed",
      -          "payment_authorized",
      -          "policy",
      -          "price",
      -          "retention",
      -          "service_id",
      -          "status_version",
      -          "supported_input_types"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "receipt"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "$schema": "https://json-schema.org/draft/2020-12/schema",
      +        "additionalProperties": false,
      +        "properties": {
      +          "availability": {
      +            "additionalProperties": false,
      +            "description": "Cached runtime readiness, not a fresh external probe or settlement proof.",
      +            "properties": {
      +              "ready": {
      +                "description": "Whether the launch gate and cached dependencies currently allow paid processing.",
      +                "type": "boolean"
      +              },
      +              "reason": {
      +                "description": "Coarse public readiness reason; contains no internal error details.",
      +                "enum": [
      +                  "ready",
      +                  "launch_gate_closed",
      +                  "dependency_unavailable",
      +                  "not_configured"
      +                ]
      +              },
      +              "source": {
      +                "const": "cached_runtime_readiness"
      +              }
      +            },
      +            "required": [
      +              "ready",
      +              "reason",
      +              "source"
      +            ],
      +            "type": "object"
      +          },
      +          "limits": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "max_existing_fingerprints": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_line_items": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_pages": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_request_bytes": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_text_characters": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "normal_latency_target_ms": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "request_timeout_ms": {
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "max_existing_fingerprints",
      +              "max_line_items",
      +              "max_pages",
      +              "max_request_bytes",
      +              "max_text_characters",
      +              "normal_latency_target_ms",
      +              "request_timeout_ms"
      +            ],
      +            "type": "object"
      +          },
      +          "paid_processing_performed": {
      +            "const": false
      +          },
      +          "payment_authorized": {
      +            "const": false
      +          },
      +          "policy": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "advisory_only": {
      +                "const": true
      +              },
      +              "ardaro_saas_tenant_access": {
      +                "const": false
      +              },
      +              "financial_mutation_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              }
      +            },
      +            "required": [
      +              "advisory_only",
      +              "human_review_required",
      +              "financial_mutation_supported",
      +              "ardaro_saas_tenant_access"
      +            ],
      +            "type": "object"
      +          },
      +          "price": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "amount": {
      +                "pattern": "^[0-9]+\\.[0-9]{2}$",
      +                "type": "string"
      +              },
      +              "currency": {
      +                "const": "USDC"
      +              },
      +              "display": {
      +                "pattern": "^\\$[0-9]+\\.[0-9]{2}$",
      +                "type": "string"
      +              },
      +              "failed_input_validation_charged": {
      +                "const": false
      +              },
      +              "model": {
      +                "const": "fixed_per_accepted_request"
      +              },
      +              "network": {
      +                "type": "string"
      +              },
      +              "same_payment_identifier_replay_requires_new_payment": {
      +                "const": false
      +              },
      +              "successful_response_loss_retry_policy": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "model",
      +              "amount",
      +              "currency",
      +              "display",
      +              "network",
      +              "failed_input_validation_charged",
      +              "same_payment_identifier_replay_requires_new_payment",
      +              "successful_response_loss_retry_policy"
      +            ],
      +            "type": "object"
      +          },
      +          "retention": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "default_retention_seconds": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "deletion_behavior": {
      +                "type": "string"
      +              },
      +              "durable_recovery_supported": {
      +                "type": "boolean"
      +              },
      +              "extracted_results_retained": {
      +                "type": "boolean"
      +              },
      +              "payment_metadata_retention_seconds": {
      +                "minimum": 86400,
      +                "type": "integer"
      +              },
      +              "raw_documents_retained": {
      +                "const": false
      +              },
      +              "raw_receipt_images_retained": {
      +                "const": false
      +              },
      +              "storage_scope": {
      +                "type": "string"
      +              },
      +              "used_for_model_training": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "default_retention_seconds",
      +              "deletion_behavior",
      +              "durable_recovery_supported",
      +              "extracted_results_retained",
      +              "payment_metadata_retention_seconds",
      +              "raw_documents_retained",
      +              "raw_receipt_images_retained",
      +              "storage_scope",
      +              "used_for_model_training"
      +            ],
      +            "type": "object"
      +          },
      +          "service_id": {
      +            "const": "ardaro.receipt_intelligence"
      +          },
      +          "status_version": {
      +            "const": "ardaro.receipt-intelligence.service-status.v1"
      +          },
      +          "supported_input_types": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "description": {
      +                  "type": "string"
      +                },
      +                "input_kind": {
      +                  "enum": [
      +                    "text",
      +                    "structured"
      +                  ]
      +                },
      +                "mime_type": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mime_type",
      +                "input_kind",
      +                "description"
      +              ],
      +              "type": "object"
      +            },
      +            "minItems": 1,
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "availability",
      +          "limits",
      +          "paid_processing_performed",
      +          "payment_authorized",
      +          "policy",
      +          "price",
      +          "retention",
      +          "service_id",
      +          "status_version",
      +          "supported_input_types"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "receipt"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "additionalProperties": false,
      +        "allOf": [
      +          {
      +            "else": {
      +              "properties": {
      +                "reason": {
      +                  "enum": [
      +                    "launch_gated",
      +                    "dependency_unavailable"
      +                  ]
      +                }
      +              }
      +            },
      +            "if": {
      +              "properties": {
      +                "ready": {
      +                  "const": true
      +                }
      +              }
      +            },
      +            "then": {
      +              "properties": {
      +                "reason": {
      +                  "const": "ready"
      +                }
      +              }
      +            }
      +          }
      +        ],
      +        "properties": {
      +          "endpoints": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "analyze": {
      +                "format": "uri",
      +                "maxLength": 600,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^https?://[^/?#]+/v1/invoice-matching/analyze$",
      +                "type": "string"
      +              },
      +              "example": {
      +                "format": "uri",
      +                "maxLength": 600,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^https?://[^/?#]+/agent-services/invoice-matching/example$",
      +                "type": "string"
      +              },
      +              "mcp": {
      +                "format": "uri",
      +                "maxLength": 600,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^https?://[^/?#]+/mcp$",
      +                "type": "string"
      +              },
      +              "status": {
      +                "format": "uri",
      +                "maxLength": 600,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^https?://[^/?#]+/agent-services/invoice-matching/status$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "analyze",
      +              "mcp",
      +              "example",
      +              "status"
      +            ],
      +            "type": "object"
      +          },
      +          "limits": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "max_invoice_line_items": {
      +                "const": 100
      +              },
      +              "max_mcp_response_bytes": {
      +                "const": 2097152
      +              },
      +              "max_purchase_order_line_items": {
      +                "const": 100
      +              },
      +              "max_request_bytes": {
      +                "const": 262144
      +              },
      +              "max_response_bytes": {
      +                "const": 1048576
      +              },
      +              "supported_currencies": {
      +                "const": [
      +                  "AUD",
      +                  "CAD",
      +                  "EUR",
      +                  "GBP",
      +                  "JPY",
      +                  "MXN",
      +                  "USD"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "max_request_bytes",
      +              "max_invoice_line_items",
      +              "max_purchase_order_line_items",
      +              "max_response_bytes",
      +              "max_mcp_response_bytes",
      +              "supported_currencies"
      +            ],
      +            "type": "object"
      +          },
      +          "policy": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "advisory_only": {
      +                "const": true
      +              },
      +              "ardaro_saas_tenant_access": {
      +                "const": false
      +              },
      +              "delivery_verification_supported": {
      +                "const": false
      +              },
      +              "document_authentication_supported": {
      +                "const": false
      +              },
      +              "financial_mutation_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              },
      +              "ocr_supported": {
      +                "const": false
      +              },
      +              "prior_invoice_reconciliation_supported": {
      +                "const": false
      +              },
      +              "tax_validation_supported": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "advisory_only",
      +              "human_review_required",
      +              "financial_mutation_supported",
      +              "ardaro_saas_tenant_access",
      +              "ocr_supported",
      +              "delivery_verification_supported",
      +              "prior_invoice_reconciliation_supported",
      +              "tax_validation_supported",
      +              "document_authentication_supported"
      +            ],
      +            "type": "object"
      +          },
      +          "price": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "amount": {
      +                "const": "0.50"
      +              },
      +              "amount_atomic": {
      +                "const": "500000"
      +              },
      +              "currency": {
      +                "const": "USDC"
      +              },
      +              "display": {
      +                "const": "$0.50"
      +              },
      +              "failed_input_validation_charged": {
      +                "const": false
      +              },
      +              "model": {
      +                "const": "fixed_per_accepted_request"
      +              },
      +              "network": {
      +                "enum": [
      +                  "eip155:8453",
      +                  "eip155:84532"
      +                ]
      +              },
      +              "same_payment_identifier_replay_requires_new_payment": {
      +                "const": false
      +              },
      +              "successful_response_loss_retry_policy": {
      +                "const": "Retry only the identical signed payment, payment identifier and request. Never create a new signature for an unknown outcome."
      +              }
      +            },
      +            "required": [
      +              "model",
      +              "amount",
      +              "amount_atomic",
      +              "currency",
      +              "network",
      +              "display",
      +              "failed_input_validation_charged",
      +              "same_payment_identifier_replay_requires_new_payment",
      +              "successful_response_loss_retry_policy"
      +            ],
      +            "type": "object"
      +          },
      +          "ready": {
      +            "type": "boolean"
      +          },
      +          "reason": {
      +            "enum": [
      +              "ready",
      +              "launch_gated",
      +              "dependency_unavailable"
      +            ]
      +          },
      +          "retention": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "in_process_result_cache_seconds": {
      +                "maximum": 86400,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "payment_metadata_retention_seconds": {
      +                "maximum": 315360000,
      +                "minimum": 86400,
      +                "type": "integer"
      +              },
      +              "raw_documents_persisted": {
      +                "const": false
      +              },
      +              "sales_accounting": {
      +                "const": "Content-free pseudonymous invoice sales are accounted for separately from receipt sales."
      +              }
      +            },
      +            "required": [
      +              "raw_documents_persisted",
      +              "in_process_result_cache_seconds",
      +              "payment_metadata_retention_seconds",
      +              "sales_accounting"
      +            ],
      +            "type": "object"
      +          },
      +          "service_id": {
      +            "const": "ardaro.invoice_matching"
      +          },
      +          "settlement_proven": {
      +            "const": false
      +          },
      +          "status_version": {
      +            "const": "ardaro.invoice-matching.service-status.v1"
      +          }
      +        },
      +        "required": [
      +          "status_version",
      +          "service_id",
      +          "ready",
      +          "reason",
      +          "price",
      +          "limits",
      +          "retention",
      +          "policy",
      +          "settlement_proven",
      +          "endpoints"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "invoice"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "financial_posting_performed": {
      +            "const": false
      +          },
      +          "human_review_required": {
      +            "const": true
      +          },
      +          "input": {
      +            "type": "string"
      +          },
      +          "price": {
      +            "const": "free"
      +          },
      +          "ready": {
      +            "const": true
      +          },
      +          "retention": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ready",
      +          "price",
      +          "input",
      +          "retention",
      +          "human_review_required",
      +          "financial_posting_performed"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "reconciliation"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed3 schema fields changed
    • changedInput schema / properties / service / description
      Previous value: -"receipt: extraction checks; invoice: paid invoice-to-PO quantity allocation; reconciliation: free three-document discrepancy checks without allocation. Choose one service; examples do not process caller documents."New value: +"receipt: extraction checks. Examples do not process caller documents."
    • changedInput schema / properties / service / enum
      Previous value: -[
      -  "receipt",
      -  "invoice",
      -  "reconciliation"
      -]New value: +[
      +  "receipt"
      +]
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "$schema": "https://json-schema.org/draft/2020-12/schema",
      -        "additionalProperties": false,
      -        "properties": {
      -          "availability": {
      -            "additionalProperties": false,
      -            "description": "Cached runtime readiness, not a fresh external probe or settlement proof.",
      -            "properties": {
      -              "ready": {
      -                "description": "Whether the launch gate and cached dependencies currently allow paid processing.",
      -                "type": "boolean"
      -              },
      -              "reason": {
      -                "description": "Coarse public readiness reason; contains no internal error details.",
      -                "enum": [
      -                  "ready",
      -                  "launch_gate_closed",
      -                  "dependency_unavailable",
      -                  "not_configured"
      -                ]
      -              },
      -              "source": {
      -                "const": "cached_runtime_readiness"
      -              }
      -            },
      -            "required": [
      -              "ready",
      -              "reason",
      -              "source"
      -            ],
      -            "type": "object"
      -          },
      -          "limits": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "max_existing_fingerprints": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_line_items": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_pages": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_request_bytes": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_text_characters": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "normal_latency_target_ms": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "request_timeout_ms": {
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "max_existing_fingerprints",
      -              "max_line_items",
      -              "max_pages",
      -              "max_request_bytes",
      -              "max_text_characters",
      -              "normal_latency_target_ms",
      -              "request_timeout_ms"
      -            ],
      -            "type": "object"
      -          },
      -          "paid_processing_performed": {
      -            "const": false
      -          },
      -          "payment_authorized": {
      -            "const": false
      -          },
      -          "policy": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "advisory_only": {
      -                "const": true
      -              },
      -              "ardaro_saas_tenant_access": {
      -                "const": false
      -              },
      -              "financial_mutation_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              }
      -            },
      -            "required": [
      -              "advisory_only",
      -              "human_review_required",
      -              "financial_mutation_supported",
      -              "ardaro_saas_tenant_access"
      -            ],
      -            "type": "object"
      -          },
      -          "price": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "amount": {
      -                "pattern": "^[0-9]+\\.[0-9]{2}$",
      -                "type": "string"
      -              },
      -              "currency": {
      -                "const": "USDC"
      -              },
      -              "display": {
      -                "pattern": "^\\$[0-9]+\\.[0-9]{2}$",
      -                "type": "string"
      -              },
      -              "failed_input_validation_charged": {
      -                "const": false
      -              },
      -              "model": {
      -                "const": "fixed_per_accepted_request"
      -              },
      -              "network": {
      -                "type": "string"
      -              },
      -              "same_payment_identifier_replay_requires_new_payment": {
      -                "const": false
      -              },
      -              "successful_response_loss_retry_policy": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "model",
      -              "amount",
      -              "currency",
      -              "display",
      -              "network",
      -              "failed_input_validation_charged",
      -              "same_payment_identifier_replay_requires_new_payment",
      -              "successful_response_loss_retry_policy"
      -            ],
      -            "type": "object"
      -          },
      -          "retention": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "default_retention_seconds": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "deletion_behavior": {
      -                "type": "string"
      -              },
      -              "durable_recovery_supported": {
      -                "type": "boolean"
      -              },
      -              "extracted_results_retained": {
      -                "type": "boolean"
      -              },
      -              "payment_metadata_retention_seconds": {
      -                "minimum": 86400,
      -                "type": "integer"
      -              },
      -              "raw_documents_retained": {
      -                "const": false
      -              },
      -              "raw_receipt_images_retained": {
      -                "const": false
      -              },
      -              "storage_scope": {
      -                "type": "string"
      -              },
      -              "used_for_model_training": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "default_retention_seconds",
      -              "deletion_behavior",
      -              "durable_recovery_supported",
      -              "extracted_results_retained",
      -              "payment_metadata_retention_seconds",
      -              "raw_documents_retained",
      -              "raw_receipt_images_retained",
      -              "storage_scope",
      -              "used_for_model_training"
      -            ],
      -            "type": "object"
      -          },
      -          "service_id": {
      -            "const": "ardaro.receipt_intelligence"
      -          },
      -          "status_version": {
      -            "const": "ardaro.receipt-intelligence.service-status.v1"
      -          },
      -          "supported_input_types": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "description": {
      -                  "type": "string"
      -                },
      -                "input_kind": {
      -                  "enum": [
      -                    "text",
      -                    "structured"
      -                  ]
      -                },
      -                "mime_type": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "mime_type",
      -                "input_kind",
      -                "description"
      -              ],
      -              "type": "object"
      -            },
      -            "minItems": 1,
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "availability",
      -          "limits",
      -          "paid_processing_performed",
      -          "payment_authorized",
      -          "policy",
      -          "price",
      -          "retention",
      -          "service_id",
      -          "status_version",
      -          "supported_input_types"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "receipt"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "additionalProperties": false,
      -        "allOf": [
      -          {
      -            "else": {
      -              "properties": {
      -                "reason": {
      -                  "enum": [
      -                    "launch_gated",
      -                    "dependency_unavailable"
      -                  ]
      -                }
      -              }
      -            },
      -            "if": {
      -              "properties": {
      -                "ready": {
      -                  "const": true
      -                }
      -              }
      -            },
      -            "then": {
      -              "properties": {
      -                "reason": {
      -                  "const": "ready"
      -                }
      -              }
      -            }
      -          }
      -        ],
      -        "properties": {
      -          "endpoints": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "analyze": {
      -                "format": "uri",
      -                "maxLength": 600,
      -                "minLength": 1,
      -                "not": {
      -                  "pattern": "\\n"
      -                },
      -                "pattern": "^https?://[^/?#]+/v1/invoice-matching/analyze$",
      -                "type": "string"
      -              },
      -              "example": {
      -                "format": "uri",
      -                "maxLength": 600,
      -                "minLength": 1,
      -                "not": {
      -                  "pattern": "\\n"
      -                },
      -                "pattern": "^https?://[^/?#]+/agent-services/invoice-matching/example$",
      -                "type": "string"
      -              },
      -              "mcp": {
      -                "format": "uri",
      -                "maxLength": 600,
      -                "minLength": 1,
      -                "not": {
      -                  "pattern": "\\n"
      -                },
      -                "pattern": "^https?://[^/?#]+/mcp$",
      -                "type": "string"
      -              },
      -              "status": {
      -                "format": "uri",
      -                "maxLength": 600,
      -                "minLength": 1,
      -                "not": {
      -                  "pattern": "\\n"
      -                },
      -                "pattern": "^https?://[^/?#]+/agent-services/invoice-matching/status$",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "analyze",
      -              "mcp",
      -              "example",
      -              "status"
      -            ],
      -            "type": "object"
      -          },
      -          "limits": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "max_invoice_line_items": {
      -                "const": 100
      -              },
      -              "max_mcp_response_bytes": {
      -                "const": 2097152
      -              },
      -              "max_purchase_order_line_items": {
      -                "const": 100
      -              },
      -              "max_request_bytes": {
      -                "const": 262144
      -              },
      -              "max_response_bytes": {
      -                "const": 1048576
      -              },
      -              "supported_currencies": {
      -                "const": [
      -                  "AUD",
      -                  "CAD",
      -                  "EUR",
      -                  "GBP",
      -                  "JPY",
      -                  "MXN",
      -                  "USD"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "max_request_bytes",
      -              "max_invoice_line_items",
      -              "max_purchase_order_line_items",
      -              "max_response_bytes",
      -              "max_mcp_response_bytes",
      -              "supported_currencies"
      -            ],
      -            "type": "object"
      -          },
      -          "policy": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "advisory_only": {
      -                "const": true
      -              },
      -              "ardaro_saas_tenant_access": {
      -                "const": false
      -              },
      -              "delivery_verification_supported": {
      -                "const": false
      -              },
      -              "document_authentication_supported": {
      -                "const": false
      -              },
      -              "financial_mutation_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              },
      -              "ocr_supported": {
      -                "const": false
      -              },
      -              "prior_invoice_reconciliation_supported": {
      -                "const": false
      -              },
      -              "tax_validation_supported": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "advisory_only",
      -              "human_review_required",
      -              "financial_mutation_supported",
      -              "ardaro_saas_tenant_access",
      -              "ocr_supported",
      -              "delivery_verification_supported",
      -              "prior_invoice_reconciliation_supported",
      -              "tax_validation_supported",
      -              "document_authentication_supported"
      -            ],
      -            "type": "object"
      -          },
      -          "price": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "amount": {
      -                "const": "0.50"
      -              },
      -              "amount_atomic": {
      -                "const": "500000"
      -              },
      -              "currency": {
      -                "const": "USDC"
      -              },
      -              "display": {
      -                "const": "$0.50"
      -              },
      -              "failed_input_validation_charged": {
      -                "const": false
      -              },
      -              "model": {
      -                "const": "fixed_per_accepted_request"
      -              },
      -              "network": {
      -                "enum": [
      -                  "eip155:8453",
      -                  "eip155:84532"
      -                ]
      -              },
      -              "same_payment_identifier_replay_requires_new_payment": {
      -                "const": false
      -              },
      -              "successful_response_loss_retry_policy": {
      -                "const": "Retry only the identical signed payment, payment identifier and request. Never create a new signature for an unknown outcome."
      -              }
      -            },
      -            "required": [
      -              "model",
      -              "amount",
      -              "amount_atomic",
      -              "currency",
      -              "network",
      -              "display",
      -              "failed_input_validation_charged",
      -              "same_payment_identifier_replay_requires_new_payment",
      -              "successful_response_loss_retry_policy"
      -            ],
      -            "type": "object"
      -          },
      -          "ready": {
      -            "type": "boolean"
      -          },
      -          "reason": {
      -            "enum": [
      -              "ready",
      -              "launch_gated",
      -              "dependency_unavailable"
      -            ]
      -          },
      -          "retention": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "in_process_result_cache_seconds": {
      -                "maximum": 86400,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "payment_metadata_retention_seconds": {
      -                "maximum": 315360000,
      -                "minimum": 86400,
      -                "type": "integer"
      -              },
      -              "raw_documents_persisted": {
      -                "const": false
      -              },
      -              "sales_accounting": {
      -                "const": "Content-free pseudonymous invoice sales are accounted for separately from receipt sales."
      -              }
      -            },
      -            "required": [
      -              "raw_documents_persisted",
      -              "in_process_result_cache_seconds",
      -              "payment_metadata_retention_seconds",
      -              "sales_accounting"
      -            ],
      -            "type": "object"
      -          },
      -          "service_id": {
      -            "const": "ardaro.invoice_matching"
      -          },
      -          "settlement_proven": {
      -            "const": false
      -          },
      -          "status_version": {
      -            "const": "ardaro.invoice-matching.service-status.v1"
      -          }
      -        },
      -        "required": [
      -          "status_version",
      -          "service_id",
      -          "ready",
      -          "reason",
      -          "price",
      -          "limits",
      -          "retention",
      -          "policy",
      -          "settlement_proven",
      -          "endpoints"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "invoice"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "financial_posting_performed": {
      -            "const": false
      -          },
      -          "human_review_required": {
      -            "const": true
      -          },
      -          "input": {
      -            "type": "string"
      -          },
      -          "price": {
      -            "const": "free"
      -          },
      -          "ready": {
      -            "const": true
      -          },
      -          "retention": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "ready",
      -          "price",
      -          "input",
      -          "retention",
      -          "human_review_required",
      -          "financial_posting_performed"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "reconciliation"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "$schema": "https://json-schema.org/draft/2020-12/schema",
      +        "additionalProperties": false,
      +        "properties": {
      +          "availability": {
      +            "additionalProperties": false,
      +            "description": "Cached runtime readiness, not a fresh external probe or settlement proof.",
      +            "properties": {
      +              "ready": {
      +                "description": "Whether the launch gate and cached dependencies currently allow paid processing.",
      +                "type": "boolean"
      +              },
      +              "reason": {
      +                "description": "Coarse public readiness reason; contains no internal error details.",
      +                "enum": [
      +                  "ready",
      +                  "launch_gate_closed",
      +                  "dependency_unavailable",
      +                  "not_configured"
      +                ]
      +              },
      +              "source": {
      +                "const": "cached_runtime_readiness"
      +              }
      +            },
      +            "required": [
      +              "ready",
      +              "reason",
      +              "source"
      +            ],
      +            "type": "object"
      +          },
      +          "limits": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "max_existing_fingerprints": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_line_items": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_pages": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_request_bytes": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_text_characters": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "normal_latency_target_ms": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "request_timeout_ms": {
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "max_existing_fingerprints",
      +              "max_line_items",
      +              "max_pages",
      +              "max_request_bytes",
      +              "max_text_characters",
      +              "normal_latency_target_ms",
      +              "request_timeout_ms"
      +            ],
      +            "type": "object"
      +          },
      +          "paid_processing_performed": {
      +            "const": false
      +          },
      +          "payment_authorized": {
      +            "const": false
      +          },
      +          "policy": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "advisory_only": {
      +                "const": true
      +              },
      +              "ardaro_saas_tenant_access": {
      +                "const": false
      +              },
      +              "financial_mutation_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              }
      +            },
      +            "required": [
      +              "advisory_only",
      +              "human_review_required",
      +              "financial_mutation_supported",
      +              "ardaro_saas_tenant_access"
      +            ],
      +            "type": "object"
      +          },
      +          "price": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "amount": {
      +                "pattern": "^[0-9]+\\.[0-9]{2}$",
      +                "type": "string"
      +              },
      +              "currency": {
      +                "const": "USDC"
      +              },
      +              "display": {
      +                "pattern": "^\\$[0-9]+\\.[0-9]{2}$",
      +                "type": "string"
      +              },
      +              "failed_input_validation_charged": {
      +                "const": false
      +              },
      +              "model": {
      +                "const": "fixed_per_accepted_request"
      +              },
      +              "network": {
      +                "type": "string"
      +              },
      +              "same_payment_identifier_replay_requires_new_payment": {
      +                "const": false
      +              },
      +              "successful_response_loss_retry_policy": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "model",
      +              "amount",
      +              "currency",
      +              "display",
      +              "network",
      +              "failed_input_validation_charged",
      +              "same_payment_identifier_replay_requires_new_payment",
      +              "successful_response_loss_retry_policy"
      +            ],
      +            "type": "object"
      +          },
      +          "retention": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "default_retention_seconds": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "deletion_behavior": {
      +                "type": "string"
      +              },
      +              "durable_recovery_supported": {
      +                "type": "boolean"
      +              },
      +              "extracted_results_retained": {
      +                "type": "boolean"
      +              },
      +              "payment_metadata_retention_seconds": {
      +                "minimum": 86400,
      +                "type": "integer"
      +              },
      +              "raw_documents_retained": {
      +                "const": false
      +              },
      +              "raw_receipt_images_retained": {
      +                "const": false
      +              },
      +              "storage_scope": {
      +                "type": "string"
      +              },
      +              "used_for_model_training": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "default_retention_seconds",
      +              "deletion_behavior",
      +              "durable_recovery_supported",
      +              "extracted_results_retained",
      +              "payment_metadata_retention_seconds",
      +              "raw_documents_retained",
      +              "raw_receipt_images_retained",
      +              "storage_scope",
      +              "used_for_model_training"
      +            ],
      +            "type": "object"
      +          },
      +          "service_id": {
      +            "const": "ardaro.receipt_intelligence"
      +          },
      +          "status_version": {
      +            "const": "ardaro.receipt-intelligence.service-status.v1"
      +          },
      +          "supported_input_types": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "description": {
      +                  "type": "string"
      +                },
      +                "input_kind": {
      +                  "enum": [
      +                    "text",
      +                    "structured"
      +                  ]
      +                },
      +                "mime_type": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mime_type",
      +                "input_kind",
      +                "description"
      +              ],
      +              "type": "object"
      +            },
      +            "minItems": 1,
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "availability",
      +          "limits",
      +          "paid_processing_performed",
      +          "payment_authorized",
      +          "policy",
      +          "price",
      +          "retention",
      +          "service_id",
      +          "status_version",
      +          "supported_input_types"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "receipt"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "$schema": "https://json-schema.org/draft/2020-12/schema",
      -        "additionalProperties": false,
      -        "properties": {
      -          "availability": {
      -            "additionalProperties": false,
      -            "description": "Cached runtime readiness, not a fresh external probe or settlement proof.",
      -            "properties": {
      -              "ready": {
      -                "description": "Whether the launch gate and cached dependencies currently allow paid processing.",
      -                "type": "boolean"
      -              },
      -              "reason": {
      -                "description": "Coarse public readiness reason; contains no internal error details.",
      -                "enum": [
      -                  "ready",
      -                  "launch_gate_closed",
      -                  "dependency_unavailable",
      -                  "not_configured"
      -                ]
      -              },
      -              "source": {
      -                "const": "cached_runtime_readiness"
      -              }
      -            },
      -            "required": [
      -              "ready",
      -              "reason",
      -              "source"
      -            ],
      -            "type": "object"
      -          },
      -          "limits": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "max_existing_fingerprints": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_line_items": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_pages": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_request_bytes": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "max_text_characters": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "normal_latency_target_ms": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "request_timeout_ms": {
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "max_existing_fingerprints",
      -              "max_line_items",
      -              "max_pages",
      -              "max_request_bytes",
      -              "max_text_characters",
      -              "normal_latency_target_ms",
      -              "request_timeout_ms"
      -            ],
      -            "type": "object"
      -          },
      -          "paid_processing_performed": {
      -            "const": false
      -          },
      -          "payment_authorized": {
      -            "const": false
      -          },
      -          "policy": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "advisory_only": {
      -                "const": true
      -              },
      -              "ardaro_saas_tenant_access": {
      -                "const": false
      -              },
      -              "financial_mutation_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              }
      -            },
      -            "required": [
      -              "advisory_only",
      -              "human_review_required",
      -              "financial_mutation_supported",
      -              "ardaro_saas_tenant_access"
      -            ],
      -            "type": "object"
      -          },
      -          "price": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "amount": {
      -                "pattern": "^[0-9]+\\.[0-9]{2}$",
      -                "type": "string"
      -              },
      -              "currency": {
      -                "const": "USDC"
      -              },
      -              "display": {
      -                "pattern": "^\\$[0-9]+\\.[0-9]{2}$",
      -                "type": "string"
      -              },
      -              "failed_input_validation_charged": {
      -                "const": false
      -              },
      -              "model": {
      -                "const": "fixed_per_accepted_request"
      -              },
      -              "network": {
      -                "type": "string"
      -              },
      -              "same_payment_identifier_replay_requires_new_payment": {
      -                "const": false
      -              },
      -              "successful_response_loss_retry_policy": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "model",
      -              "amount",
      -              "currency",
      -              "display",
      -              "network",
      -              "failed_input_validation_charged",
      -              "same_payment_identifier_replay_requires_new_payment",
      -              "successful_response_loss_retry_policy"
      -            ],
      -            "type": "object"
      -          },
      -          "retention": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "default_retention_seconds": {
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "deletion_behavior": {
      -                "type": "string"
      -              },
      -              "durable_recovery_supported": {
      -                "type": "boolean"
      -              },
      -              "extracted_results_retained": {
      -                "type": "boolean"
      -              },
      -              "payment_metadata_retention_seconds": {
      -                "minimum": 86400,
      -                "type": "integer"
      -              },
      -              "raw_documents_retained": {
      -                "const": false
      -              },
      -              "raw_receipt_images_retained": {
      -                "const": false
      -              },
      -              "storage_scope": {
      -                "type": "string"
      -              },
      -              "used_for_model_training": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "default_retention_seconds",
      -              "deletion_behavior",
      -              "durable_recovery_supported",
      -              "extracted_results_retained",
      -              "payment_metadata_retention_seconds",
      -              "raw_documents_retained",
      -              "raw_receipt_images_retained",
      -              "storage_scope",
      -              "used_for_model_training"
      -            ],
      -            "type": "object"
      -          },
      -          "service_id": {
      -            "const": "ardaro.receipt_intelligence"
      -          },
      -          "status_version": {
      -            "const": "ardaro.receipt-intelligence.service-status.v1"
      -          },
      -          "supported_input_types": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "description": {
      -                  "type": "string"
      -                },
      -                "input_kind": {
      -                  "enum": [
      -                    "text",
      -                    "structured"
      -                  ]
      -                },
      -                "mime_type": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "mime_type",
      -                "input_kind",
      -                "description"
      -              ],
      -              "type": "object"
      -            },
      -            "minItems": 1,
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "availability",
      -          "limits",
      -          "paid_processing_performed",
      -          "payment_authorized",
      -          "policy",
      -          "price",
      -          "retention",
      -          "service_id",
      -          "status_version",
      -          "supported_input_types"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "receipt"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "additionalProperties": false,
      -        "allOf": [
      -          {
      -            "else": {
      -              "properties": {
      -                "reason": {
      -                  "enum": [
      -                    "launch_gated",
      -                    "dependency_unavailable"
      -                  ]
      -                }
      -              }
      -            },
      -            "if": {
      -              "properties": {
      -                "ready": {
      -                  "const": true
      -                }
      -              }
      -            },
      -            "then": {
      -              "properties": {
      -                "reason": {
      -                  "const": "ready"
      -                }
      -              }
      -            }
      -          }
      -        ],
      -        "properties": {
      -          "endpoints": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "analyze": {
      -                "format": "uri",
      -                "maxLength": 600,
      -                "minLength": 1,
      -                "pattern": "^https?://[^/?#]+/v1/invoice-matching/analyze(?![\\s\\S])",
      -                "type": "string"
      -              },
      -              "example": {
      -                "format": "uri",
      -                "maxLength": 600,
      -                "minLength": 1,
      -                "pattern": "^https?://[^/?#]+/agent-services/invoice-matching/example(?![\\s\\S])",
      -                "type": "string"
      -              },
      -              "mcp": {
      -                "format": "uri",
      -                "maxLength": 600,
      -                "minLength": 1,
      -                "pattern": "^https?://[^/?#]+/mcp(?![\\s\\S])",
      -                "type": "string"
      -              },
      -              "status": {
      -                "format": "uri",
      -                "maxLength": 600,
      -                "minLength": 1,
      -                "pattern": "^https?://[^/?#]+/agent-services/invoice-matching/status(?![\\s\\S])",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "analyze",
      -              "mcp",
      -              "example",
      -              "status"
      -            ],
      -            "type": "object"
      -          },
      -          "limits": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "max_invoice_line_items": {
      -                "const": 100
      -              },
      -              "max_mcp_response_bytes": {
      -                "const": 2097152
      -              },
      -              "max_purchase_order_line_items": {
      -                "const": 100
      -              },
      -              "max_request_bytes": {
      -                "const": 262144
      -              },
      -              "max_response_bytes": {
      -                "const": 1048576
      -              },
      -              "supported_currencies": {
      -                "const": [
      -                  "AUD",
      -                  "CAD",
      -                  "EUR",
      -                  "GBP",
      -                  "JPY",
      -                  "MXN",
      -                  "USD"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "max_request_bytes",
      -              "max_invoice_line_items",
      -              "max_purchase_order_line_items",
      -              "max_response_bytes",
      -              "max_mcp_response_bytes",
      -              "supported_currencies"
      -            ],
      -            "type": "object"
      -          },
      -          "policy": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "advisory_only": {
      -                "const": true
      -              },
      -              "ardaro_saas_tenant_access": {
      -                "const": false
      -              },
      -              "delivery_verification_supported": {
      -                "const": false
      -              },
      -              "document_authentication_supported": {
      -                "const": false
      -              },
      -              "financial_mutation_supported": {
      -                "const": false
      -              },
      -              "human_review_required": {
      -                "const": true
      -              },
      -              "ocr_supported": {
      -                "const": false
      -              },
      -              "prior_invoice_reconciliation_supported": {
      -                "const": false
      -              },
      -              "tax_validation_supported": {
      -                "const": false
      -              }
      -            },
      -            "required": [
      -              "advisory_only",
      -              "human_review_required",
      -              "financial_mutation_supported",
      -              "ardaro_saas_tenant_access",
      -              "ocr_supported",
      -              "delivery_verification_supported",
      -              "prior_invoice_reconciliation_supported",
      -              "tax_validation_supported",
      -              "document_authentication_supported"
      -            ],
      -            "type": "object"
      -          },
      -          "price": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "amount": {
      -                "const": "0.50"
      -              },
      -              "amount_atomic": {
      -                "const": "500000"
      -              },
      -              "currency": {
      -                "const": "USDC"
      -              },
      -              "display": {
      -                "const": "$0.50"
      -              },
      -              "failed_input_validation_charged": {
      -                "const": false
      -              },
      -              "model": {
      -                "const": "fixed_per_accepted_request"
      -              },
      -              "network": {
      -                "enum": [
      -                  "eip155:8453",
      -                  "eip155:84532"
      -                ]
      -              },
      -              "same_payment_identifier_replay_requires_new_payment": {
      -                "const": false
      -              },
      -              "successful_response_loss_retry_policy": {
      -                "const": "Retry only the identical signed payment, payment identifier and request. Never create a new signature for an unknown outcome."
      -              }
      -            },
      -            "required": [
      -              "model",
      -              "amount",
      -              "amount_atomic",
      -              "currency",
      -              "network",
      -              "display",
      -              "failed_input_validation_charged",
      -              "same_payment_identifier_replay_requires_new_payment",
      -              "successful_response_loss_retry_policy"
      -            ],
      -            "type": "object"
      -          },
      -          "ready": {
      -            "type": "boolean"
      -          },
      -          "reason": {
      -            "enum": [
      -              "ready",
      -              "launch_gated",
      -              "dependency_unavailable"
      -            ]
      -          },
      -          "retention": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "in_process_result_cache_seconds": {
      -                "maximum": 86400,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "payment_metadata_retention_seconds": {
      -                "maximum": 315360000,
      -                "minimum": 86400,
      -                "type": "integer"
      -              },
      -              "raw_documents_persisted": {
      -                "const": false
      -              },
      -              "sales_accounting": {
      -                "const": "Content-free pseudonymous invoice sales are accounted for separately from receipt sales."
      -              }
      -            },
      -            "required": [
      -              "raw_documents_persisted",
      -              "in_process_result_cache_seconds",
      -              "payment_metadata_retention_seconds",
      -              "sales_accounting"
      -            ],
      -            "type": "object"
      -          },
      -          "service_id": {
      -            "const": "ardaro.invoice_matching"
      -          },
      -          "settlement_proven": {
      -            "const": false
      -          },
      -          "status_version": {
      -            "const": "ardaro.invoice-matching.service-status.v1"
      -          }
      -        },
      -        "required": [
      -          "status_version",
      -          "service_id",
      -          "ready",
      -          "reason",
      -          "price",
      -          "limits",
      -          "retention",
      -          "policy",
      -          "settlement_proven",
      -          "endpoints"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "invoice"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "financial_posting_performed": {
      -            "const": false
      -          },
      -          "human_review_required": {
      -            "const": true
      -          },
      -          "input": {
      -            "type": "string"
      -          },
      -          "price": {
      -            "const": "free"
      -          },
      -          "ready": {
      -            "const": true
      -          },
      -          "retention": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "ready",
      -          "price",
      -          "input",
      -          "retention",
      -          "human_review_required",
      -          "financial_posting_performed"
      -        ],
      -        "type": "object"
      -      },
      -      "service": {
      -        "const": "reconciliation"
      -      }
      -    },
      -    "required": [
      -      "service",
      -      "details"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "$schema": "https://json-schema.org/draft/2020-12/schema",
      +        "additionalProperties": false,
      +        "properties": {
      +          "availability": {
      +            "additionalProperties": false,
      +            "description": "Cached runtime readiness, not a fresh external probe or settlement proof.",
      +            "properties": {
      +              "ready": {
      +                "description": "Whether the launch gate and cached dependencies currently allow paid processing.",
      +                "type": "boolean"
      +              },
      +              "reason": {
      +                "description": "Coarse public readiness reason; contains no internal error details.",
      +                "enum": [
      +                  "ready",
      +                  "launch_gate_closed",
      +                  "dependency_unavailable",
      +                  "not_configured"
      +                ]
      +              },
      +              "source": {
      +                "const": "cached_runtime_readiness"
      +              }
      +            },
      +            "required": [
      +              "ready",
      +              "reason",
      +              "source"
      +            ],
      +            "type": "object"
      +          },
      +          "limits": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "max_existing_fingerprints": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_line_items": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_pages": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_request_bytes": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "max_text_characters": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "normal_latency_target_ms": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "request_timeout_ms": {
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "max_existing_fingerprints",
      +              "max_line_items",
      +              "max_pages",
      +              "max_request_bytes",
      +              "max_text_characters",
      +              "normal_latency_target_ms",
      +              "request_timeout_ms"
      +            ],
      +            "type": "object"
      +          },
      +          "paid_processing_performed": {
      +            "const": false
      +          },
      +          "payment_authorized": {
      +            "const": false
      +          },
      +          "policy": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "advisory_only": {
      +                "const": true
      +              },
      +              "ardaro_saas_tenant_access": {
      +                "const": false
      +              },
      +              "financial_mutation_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              }
      +            },
      +            "required": [
      +              "advisory_only",
      +              "human_review_required",
      +              "financial_mutation_supported",
      +              "ardaro_saas_tenant_access"
      +            ],
      +            "type": "object"
      +          },
      +          "price": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "amount": {
      +                "pattern": "^[0-9]+\\.[0-9]{2}$",
      +                "type": "string"
      +              },
      +              "currency": {
      +                "const": "USDC"
      +              },
      +              "display": {
      +                "pattern": "^\\$[0-9]+\\.[0-9]{2}$",
      +                "type": "string"
      +              },
      +              "failed_input_validation_charged": {
      +                "const": false
      +              },
      +              "model": {
      +                "const": "fixed_per_accepted_request"
      +              },
      +              "network": {
      +                "type": "string"
      +              },
      +              "same_payment_identifier_replay_requires_new_payment": {
      +                "const": false
      +              },
      +              "successful_response_loss_retry_policy": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "model",
      +              "amount",
      +              "currency",
      +              "display",
      +              "network",
      +              "failed_input_validation_charged",
      +              "same_payment_identifier_replay_requires_new_payment",
      +              "successful_response_loss_retry_policy"
      +            ],
      +            "type": "object"
      +          },
      +          "retention": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "default_retention_seconds": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "deletion_behavior": {
      +                "type": "string"
      +              },
      +              "durable_recovery_supported": {
      +                "type": "boolean"
      +              },
      +              "extracted_results_retained": {
      +                "type": "boolean"
      +              },
      +              "payment_metadata_retention_seconds": {
      +                "minimum": 86400,
      +                "type": "integer"
      +              },
      +              "raw_documents_retained": {
      +                "const": false
      +              },
      +              "raw_receipt_images_retained": {
      +                "const": false
      +              },
      +              "storage_scope": {
      +                "type": "string"
      +              },
      +              "used_for_model_training": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "default_retention_seconds",
      +              "deletion_behavior",
      +              "durable_recovery_supported",
      +              "extracted_results_retained",
      +              "payment_metadata_retention_seconds",
      +              "raw_documents_retained",
      +              "raw_receipt_images_retained",
      +              "storage_scope",
      +              "used_for_model_training"
      +            ],
      +            "type": "object"
      +          },
      +          "service_id": {
      +            "const": "ardaro.receipt_intelligence"
      +          },
      +          "status_version": {
      +            "const": "ardaro.receipt-intelligence.service-status.v1"
      +          },
      +          "supported_input_types": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "description": {
      +                  "type": "string"
      +                },
      +                "input_kind": {
      +                  "enum": [
      +                    "text",
      +                    "structured"
      +                  ]
      +                },
      +                "mime_type": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mime_type",
      +                "input_kind",
      +                "description"
      +              ],
      +              "type": "object"
      +            },
      +            "minItems": 1,
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "availability",
      +          "limits",
      +          "paid_processing_performed",
      +          "payment_authorized",
      +          "policy",
      +          "price",
      +          "retention",
      +          "service_id",
      +          "status_version",
      +          "supported_input_types"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "receipt"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "additionalProperties": false,
      +        "allOf": [
      +          {
      +            "else": {
      +              "properties": {
      +                "reason": {
      +                  "enum": [
      +                    "launch_gated",
      +                    "dependency_unavailable"
      +                  ]
      +                }
      +              }
      +            },
      +            "if": {
      +              "properties": {
      +                "ready": {
      +                  "const": true
      +                }
      +              }
      +            },
      +            "then": {
      +              "properties": {
      +                "reason": {
      +                  "const": "ready"
      +                }
      +              }
      +            }
      +          }
      +        ],
      +        "properties": {
      +          "endpoints": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "analyze": {
      +                "format": "uri",
      +                "maxLength": 600,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^https?://[^/?#]+/v1/invoice-matching/analyze$",
      +                "type": "string"
      +              },
      +              "example": {
      +                "format": "uri",
      +                "maxLength": 600,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^https?://[^/?#]+/agent-services/invoice-matching/example$",
      +                "type": "string"
      +              },
      +              "mcp": {
      +                "format": "uri",
      +                "maxLength": 600,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^https?://[^/?#]+/mcp$",
      +                "type": "string"
      +              },
      +              "status": {
      +                "format": "uri",
      +                "maxLength": 600,
      +                "minLength": 1,
      +                "not": {
      +                  "pattern": "\\n"
      +                },
      +                "pattern": "^https?://[^/?#]+/agent-services/invoice-matching/status$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "analyze",
      +              "mcp",
      +              "example",
      +              "status"
      +            ],
      +            "type": "object"
      +          },
      +          "limits": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "max_invoice_line_items": {
      +                "const": 100
      +              },
      +              "max_mcp_response_bytes": {
      +                "const": 2097152
      +              },
      +              "max_purchase_order_line_items": {
      +                "const": 100
      +              },
      +              "max_request_bytes": {
      +                "const": 262144
      +              },
      +              "max_response_bytes": {
      +                "const": 1048576
      +              },
      +              "supported_currencies": {
      +                "const": [
      +                  "AUD",
      +                  "CAD",
      +                  "EUR",
      +                  "GBP",
      +                  "JPY",
      +                  "MXN",
      +                  "USD"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "max_request_bytes",
      +              "max_invoice_line_items",
      +              "max_purchase_order_line_items",
      +              "max_response_bytes",
      +              "max_mcp_response_bytes",
      +              "supported_currencies"
      +            ],
      +            "type": "object"
      +          },
      +          "policy": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "advisory_only": {
      +                "const": true
      +              },
      +              "ardaro_saas_tenant_access": {
      +                "const": false
      +              },
      +              "delivery_verification_supported": {
      +                "const": false
      +              },
      +              "document_authentication_supported": {
      +                "const": false
      +              },
      +              "financial_mutation_supported": {
      +                "const": false
      +              },
      +              "human_review_required": {
      +                "const": true
      +              },
      +              "ocr_supported": {
      +                "const": false
      +              },
      +              "prior_invoice_reconciliation_supported": {
      +                "const": false
      +              },
      +              "tax_validation_supported": {
      +                "const": false
      +              }
      +            },
      +            "required": [
      +              "advisory_only",
      +              "human_review_required",
      +              "financial_mutation_supported",
      +              "ardaro_saas_tenant_access",
      +              "ocr_supported",
      +              "delivery_verification_supported",
      +              "prior_invoice_reconciliation_supported",
      +              "tax_validation_supported",
      +              "document_authentication_supported"
      +            ],
      +            "type": "object"
      +          },
      +          "price": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "amount": {
      +                "const": "0.50"
      +              },
      +              "amount_atomic": {
      +                "const": "500000"
      +              },
      +              "currency": {
      +                "const": "USDC"
      +              },
      +              "display": {
      +                "const": "$0.50"
      +              },
      +              "failed_input_validation_charged": {
      +                "const": false
      +              },
      +              "model": {
      +                "const": "fixed_per_accepted_request"
      +              },
      +              "network": {
      +                "enum": [
      +                  "eip155:8453",
      +                  "eip155:84532"
      +                ]
      +              },
      +              "same_payment_identifier_replay_requires_new_payment": {
      +                "const": false
      +              },
      +              "successful_response_loss_retry_policy": {
      +                "const": "Retry only the identical signed payment, payment identifier and request. Never create a new signature for an unknown outcome."
      +              }
      +            },
      +            "required": [
      +              "model",
      +              "amount",
      +              "amount_atomic",
      +              "currency",
      +              "network",
      +              "display",
      +              "failed_input_validation_charged",
      +              "same_payment_identifier_replay_requires_new_payment",
      +              "successful_response_loss_retry_policy"
      +            ],
      +            "type": "object"
      +          },
      +          "ready": {
      +            "type": "boolean"
      +          },
      +          "reason": {
      +            "enum": [
      +              "ready",
      +              "launch_gated",
      +              "dependency_unavailable"
      +            ]
      +          },
      +          "retention": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "in_process_result_cache_seconds": {
      +                "maximum": 86400,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "payment_metadata_retention_seconds": {
      +                "maximum": 315360000,
      +                "minimum": 86400,
      +                "type": "integer"
      +              },
      +              "raw_documents_persisted": {
      +                "const": false
      +              },
      +              "sales_accounting": {
      +                "const": "Content-free pseudonymous invoice sales are accounted for separately from receipt sales."
      +              }
      +            },
      +            "required": [
      +              "raw_documents_persisted",
      +              "in_process_result_cache_seconds",
      +              "payment_metadata_retention_seconds",
      +              "sales_accounting"
      +            ],
      +            "type": "object"
      +          },
      +          "service_id": {
      +            "const": "ardaro.invoice_matching"
      +          },
      +          "settlement_proven": {
      +            "const": false
      +          },
      +          "status_version": {
      +            "const": "ardaro.invoice-matching.service-status.v1"
      +          }
      +        },
      +        "required": [
      +          "status_version",
      +          "service_id",
      +          "ready",
      +          "reason",
      +          "price",
      +          "limits",
      +          "retention",
      +          "policy",
      +          "settlement_proven",
      +          "endpoints"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "invoice"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "financial_posting_performed": {
      +            "const": false
      +          },
      +          "human_review_required": {
      +            "const": true
      +          },
      +          "input": {
      +            "type": "string"
      +          },
      +          "price": {
      +            "const": "free"
      +          },
      +          "ready": {
      +            "const": true
      +          },
      +          "retention": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ready",
      +          "price",
      +          "input",
      +          "retention",
      +          "human_review_required",
      +          "financial_posting_performed"
      +        ],
      +        "type": "object"
      +      },
      +      "service": {
      +        "const": "reconciliation"
      +      }
      +    },
      +    "required": [
      +      "service",
      +      "details"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed1 schema field changed
    • changedInput schema / properties / service / description
      Previous value: -"Service whose fixed example or current terms to inspect."New value: +"receipt: extraction checks; invoice: paid invoice-to-PO quantity allocation; reconciliation: free three-document discrepancy checks without allocation. Choose one service; examples do not process caller documents."
  5. Added

TDQS

A4.7/5.0
Behavior5/5

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

Annotations already declare readOnly, idempotent, and non-destructive behavior, but the description adds meaningful context beyond them: 'Free cached runtime read; no external probe...' and the semantic that ready=false means the underlying service is unavailable. This clarifies the tool's actual runtime behavior and limits.

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

Conciseness5/5

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

The description is three tightly written sentences with no filler. It front-loads the primary purpose, then adds the ready=false semantics, behavioral caveats, and an alternative in a logical order.

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 the presence of an output schema, complete parameter documentation, and informative annotations, the description covers purpose, usage timing, exclusions, behavioral semantics, and an alternative. Nothing critical is missing for an agent to invoke it correctly.

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?

The schema already documents the single service parameter with full enum coverage and per-value descriptions, so the description adds little parameter-level meaning beyond referring to 'the selected service.' With 100% schema coverage, the baseline of 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 uses a specific verb ('Check') and a clear resource ('the selected service's current runtime readiness, input limits, pricing and retention'), and defines the meaning of ready=false. It also distinguishes itself from get_document_example by explicitly directing that use case elsewhere.

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 states when to use the tool ('before use'), what it is not for ('no external probe, payment, analysis or historical document retrieval'), and names an alternative ('Use get_document_example for a fixed integration sample instead'). This gives the agent explicit routing guidance.

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