Ardaro Agent Runtime Utilities

Intent classification review

route_model_intent

Read-onlyIdempotent

Classify text with a bounded keyword heuristic for human review. Does not execute a model, select a verified cheapest model or prove routing savings. Paid: 0.15 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='route_model_intent' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`intent_payload`	Yes	Caller-supplied text; do not submit secrets or private tenant data.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

AddedSep 17, 2026
RemovedSep 15, 2026

Changed1 schema field changedSep 15, 2026

changedOutput schema / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contract_version": {
-        "const": "ardaro.agent-utilities.response.v1"
-      },
-      "identities": {
-        "additionalProperties": false,
-        "properties": {
-          "analysis_result_identity": {
-            "pattern": "^res_[0-9a-f]{64}(?![\\s\\S])",
-            "type": "string"
-          },
-          "payment_identity": {
-            "additionalProperties": false,
-            "properties": {
-              "protocol": {
-                "const": "x402-v2"
-              },
-              "reference": {
-                "pattern": "^pay_[0-9a-f]{64}(?![\\s\\S])",
-                "type": "string"
-              },
-              "replayed": {
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "protocol",
-              "reference",
-              "replayed"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "analysis_result_identity",
-          "payment_identity"
-        ],
-        "type": "object"
-      },
-      "result": {
-        "additionalProperties": false,
-        "properties": {
-          "human_review_required": {
-            "const": true,
-            "type": "boolean"
-          },
-          "recommended_model": {
-            "type": "null"
-          },
-          "route_category": {
-            "enum": [
-              "structured-calculation-review",
-              "general-text-review"
-            ],
-            "type": "string"
-          },
-          "route_executed": {
-            "const": false,
-            "type": "boolean"
-          },
-          "routing_basis": {
-            "const": "Keyword heuristic only; no model capability, availability or price comparison",
-            "type": "string"
-          },
-          "status": {
-            "const": "ADVISORY_ROUTE",
-            "type": "string"
-          }
-        },
-        "required": [
-          "status",
-          "route_category",
-          "routing_basis",
-          "recommended_model",
-          "route_executed",
-          "human_review_required"
-        ],
-        "type": "object"
-      },
-      "service_id": {
-        "const": "ardaro.route_model_intent"
-      },
-      "status": {
-        "const": "review_required"
-      }
-    },
-    "required": [
-      "contract_version",
-      "service_id",
-      "status",
-      "result",
-      "identities"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "contract_version": {
-        "const": "ardaro.agent-utilities.response.v1"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "maxLength": 100,
-            "type": "string"
-          },
-          "message": {
-            "maxLength": 300,
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "error"
-      }
-    },
-    "required": [
-      "contract_version",
-      "status",
-      "error"
-    ],
-    "type": "object"
-  },
-  {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "additionalProperties": false,
-    "properties": {
-      "contract_version": {
-        "const": "ardaro.agent-receipt-intelligence.response.v1"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "maxLength": 80,
-            "type": "string"
-          },
-          "message": {
-            "maxLength": 280,
-            "type": "string"
-          },
-          "remediation": {
-            "maxLength": 280,
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          },
-          "service_code": {
-            "enum": [
-              "ARDARO_ARITHMETIC_MISMATCH",
-              "ARDARO_DOCUMENT_TOO_LARGE",
-              "ARDARO_DUPLICATE_SUSPECTED",
-              "ARDARO_EXTRACTION_LOW_CONFIDENCE",
-              "ARDARO_IDEMPOTENCY_CONFLICT",
-              "ARDARO_INPUT_UNSUPPORTED",
-              "ARDARO_PAYMENT_INVALID",
-              "ARDARO_PAYMENT_RECONCILIATION_REQUIRED",
-              "ARDARO_PAYMENT_REQUIRED",
-              "ARDARO_RATE_LIMITED",
-              "ARDARO_SERVICE_UNAVAILABLE"
-            ]
-          }
-        },
-        "required": [
-          "code",
-          "service_code",
-          "message",
-          "retryable",
-          "remediation"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "error"
-      }
-    },
-    "required": [
-      "contract_version",
-      "status",
-      "error"
-    ],
-    "type": "object"
-  },
-  {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "additionalProperties": false,
-    "properties": {
-      "contract_version": {
-        "const": "ardaro.agent-receipt-intelligence.response.v1"
-      },
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "maxLength": 80,
-            "minLength": 1,
-            "type": "string"
-          },
-          "message": {
-            "const": "Service is not ready."
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "service": {
-        "const": "ardaro-receipt-intelligence"
-      },
-      "status": {
-        "const": "not_ready"
-      }
-    },
-    "required": [
-      "contract_version",
-      "status",
-      "service",
-      "error"
-    ],
-    "type": "object"
-  },
-  {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "properties": {
-      "accepts": {
-        "items": {
-          "properties": {
-            "amount": {
-              "type": "string"
-            },
-            "asset": {
-              "type": "string"
-            },
-            "extra": {
-              "additionalProperties": true,
-              "type": "object"
-            },
-            "maxTimeoutSeconds": {
-              "type": "integer"
-            },
-            "network": {
-              "type": "string"
-            },
-            "payTo": {
-              "type": "string"
-            },
-            "scheme": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "scheme",
-            "network",
-            "asset",
-            "amount",
-            "payTo",
-            "maxTimeoutSeconds"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "error": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "extensions": {
-        "oneOf": [
-          {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "resource": {
-        "oneOf": [
-          {
-            "properties": {
-              "description": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "iconUrl": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "mimeType": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "serviceName": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "tags": {
-                "oneOf": [
-                  {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "url": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "url"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "x402Version": {
-        "const": 2,
-        "default": 2,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "accepts"
-    ],
-    "type": "object"
-  },
-  {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "message": {
-        "type": "string"
-      },
-      "status": {
-        "const": "error"
-      }
-    },
-    "required": [
-      "status",
-      "message"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contract_version": {
+        "const": "ardaro.agent-utilities.response.v1"
+      },
+      "identities": {
+        "additionalProperties": false,
+        "properties": {
+          "analysis_result_identity": {
+            "pattern": "^res_[0-9a-f]{64}$",
+            "type": "string"
+          },
+          "payment_identity": {
+            "additionalProperties": false,
+            "properties": {
+              "protocol": {
+                "const": "x402-v2"
+              },
+              "reference": {
+                "pattern": "^pay_[0-9a-f]{64}$",
+                "type": "string"
+              },
+              "replayed": {
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "protocol",
+              "reference",
+              "replayed"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "analysis_result_identity",
+          "payment_identity"
+        ],
+        "type": "object"
+      },
+      "result": {
+        "additionalProperties": false,
+        "properties": {
+          "human_review_required": {
+            "const": true,
+            "type": "boolean"
+          },
+          "recommended_model": {
+            "type": "null"
+          },
+          "route_category": {
+            "enum": [
+              "structured-calculation-review",
+              "general-text-review"
+            ],
+            "type": "string"
+          },
+          "route_executed": {
+            "const": false,
+            "type": "boolean"
+          },
+          "routing_basis": {
+            "const": "Keyword heuristic only; no model capability, availability or price comparison",
+            "type": "string"
+          },
+          "status": {
+            "const": "ADVISORY_ROUTE",
+            "type": "string"
+          }
+        },
+        "required": [
+          "status",
+          "route_category",
+          "routing_basis",
+          "recommended_model",
+          "route_executed",
+          "human_review_required"
+        ],
+        "type": "object"
+      },
+      "service_id": {
+        "const": "ardaro.route_model_intent"
+      },
+      "status": {
+        "const": "review_required"
+      }
+    },
+    "required": [
+      "contract_version",
+      "service_id",
+      "status",
+      "result",
+      "identities"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "contract_version": {
+        "const": "ardaro.agent-utilities.response.v1"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "maxLength": 100,
+            "type": "string"
+          },
+          "message": {
+            "maxLength": 300,
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "error"
+      }
+    },
+    "required": [
+      "contract_version",
+      "status",
+      "error"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "additionalProperties": false,
+    "properties": {
+      "contract_version": {
+        "const": "ardaro.agent-receipt-intelligence.response.v1"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "maxLength": 80,
+            "type": "string"
+          },
+          "message": {
+            "maxLength": 280,
+            "type": "string"
+          },
+          "remediation": {
+            "maxLength": 280,
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          },
+          "service_code": {
+            "enum": [
+              "ARDARO_ARITHMETIC_MISMATCH",
+              "ARDARO_DOCUMENT_TOO_LARGE",
+              "ARDARO_DUPLICATE_SUSPECTED",
+              "ARDARO_EXTRACTION_LOW_CONFIDENCE",
+              "ARDARO_IDEMPOTENCY_CONFLICT",
+              "ARDARO_INPUT_UNSUPPORTED",
+              "ARDARO_PAYMENT_INVALID",
+              "ARDARO_PAYMENT_RECONCILIATION_REQUIRED",
+              "ARDARO_PAYMENT_REQUIRED",
+              "ARDARO_RATE_LIMITED",
+              "ARDARO_SERVICE_UNAVAILABLE"
+            ]
+          }
+        },
+        "required": [
+          "code",
+          "service_code",
+          "message",
+          "retryable",
+          "remediation"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "error"
+      }
+    },
+    "required": [
+      "contract_version",
+      "status",
+      "error"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "additionalProperties": false,
+    "properties": {
+      "contract_version": {
+        "const": "ardaro.agent-receipt-intelligence.response.v1"
+      },
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "maxLength": 80,
+            "minLength": 1,
+            "type": "string"
+          },
+          "message": {
+            "const": "Service is not ready."
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "service": {
+        "const": "ardaro-receipt-intelligence"
+      },
+      "status": {
+        "const": "not_ready"
+      }
+    },
+    "required": [
+      "contract_version",
+      "status",
+      "service",
+      "error"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "properties": {
+      "accepts": {
+        "items": {
+          "properties": {
+            "amount": {
+              "type": "string"
+            },
+            "asset": {
+              "type": "string"
+            },
+            "extra": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "maxTimeoutSeconds": {
+              "type": "integer"
+            },
+            "network": {
+              "type": "string"
+            },
+            "payTo": {
+              "type": "string"
+            },
+            "scheme": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "scheme",
+            "network",
+            "asset",
+            "amount",
+            "payTo",
+            "maxTimeoutSeconds"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "error": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "extensions": {
+        "oneOf": [
+          {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "resource": {
+        "oneOf": [
+          {
+            "properties": {
+              "description": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "iconUrl": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "mimeType": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "serviceName": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "tags": {
+                "oneOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "url": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "url"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "x402Version": {
+        "const": 2,
+        "default": 2,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "accepts"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "error"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "message": {
+        "type": "string"
+      },
+      "status": {
+        "const": "error"
+      }
+    },
+    "required": [
+      "status",
+      "message"
+    ],
+    "type": "object"
+  }
+]

First observedSep 14, 2026

TDQS

A4.7/5.0

Behavior5/5

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

Despite readOnlyHint, idempotentHint, and destructiveHint annotations, the description adds crucial non-obvious behavior: the call is paid (0.15 USDC), charging occurs even for unfavorable results, and owner-authorized x402 payment is required. It also clarifies that tool discovery does not authorize spending, which is genuinely valuable context beyond the annotations.

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 front-loaded with the tool's core purpose, followed by essential constraints about cost and prerequisites. Every sentence carries necessary information for safe selection and invocation. It is dense but not bloated.

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?

With one fully documented parameter, an output schema, and annotations already covering the non-destructive, idempotent nature, the description fills the remaining contextual gaps: payment, authorization, service status check, and the free example. Nothing needed to call this tool correctly is missing.

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

Parameters3/5

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

Schema coverage is 100% and the only parameter is fully documented. The description does not add new parameter-level meaning beyond naming the text classification use case, so the baseline score 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 states a specific verb and resource: 'Classify text with a bounded keyword heuristic for human review.' It explicitly distinguishes itself from model execution by stating it does not execute a model and cannot select a cheapest model or prove routing savings, which fully removes ambiguity implied by the tool name.

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

Usage Guidelines5/5

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

The description gives explicit prerequisites and when-not conditions: it tells the agent to check get_utility_service_status for the service and to try the free fixed example first. It also clearly excludes use cases around real model execution or routing-savings proof and warns about the x402 payment requirement.

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

All Ardaro Agent Runtime Utilities tools Inspect

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?