Skip to main content
Glama

agentcore_route

Task router over paid agent services; free top-1 recommendation or paid $0.01 ranked top-three with ghost-bid counterfactual pricing, qualified handoff and receipt binding. $0.01/call via x402.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
taskYes
max_priceYes
price_capNo
constraintsNo
output_formatNo
preferred_railNo
prior_bid_atomicNo
seller_delivery_receiptNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / max_price
      Added value: +{
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / prior_bid_atomic
      Added value: +{
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "task"
      -]New value: +[
      +  "task",
      +  "max_price"
      +]
  2. Added

TDQS

C2.9/5.0
Behavior3/5

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

Since no annotations are provided, the description must carry full burden. It does disclose the cost model ($0.01/call via x402), the free/paid behavior difference, and mentions problem-aware behaviors like ghost-bid counterfactual pricing, handoff, and receipt binding. Yet it does not cover rates on limits, what happens if pay/latencies, how constraints or rail choices behave, or error/refund scenarios, leaving agents without complete behavioral predictability.

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

Conciseness4/5

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

The description is a compact, front-loaded sentence or two that quickly establishes router identity, the free/paid distinction, and the cost. No filler or redundant restating. It is slightly run-on but stays within the constraints of a high-signal description.

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

Completeness2/5

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

Given 8 parameters, no output schema, and no annotations, the description should cover far more. It explains the business model and gives strong top-level facts, but leaves foundational operational semantics (what 'qualified handoff' does, how price caps function, what 'receipt binding' means in practice, and what the response looks like) unstated, making it incomplete for a tool this complex.

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

Parameters1/5

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

Schema description coverage is 0%, and the description has no meaningful parameter docs. It never maps max_price or price_cap boundaries, does not define constraints, ignored output_format and preferred_rail, and silently relies on opaque fields like prior_bid_atomic and seller_delivery_receipt. The only related hint is that costs $0.01, which is not enough to set parameters correctly for an 8-field tool with no schema commentary.

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

Purpose4/5

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

The description clearly states the tool is a 'task router over paid agent services' and gives strong specifics: free top-1 vs paid $0.01 ranked top-three, ghost-bid counterfactual pricing, qualified handoff, receipt binding, and the x402 rail. It does not name or explicitly contrast with siblings like route_task or mpp_route, but the unique pricing/model details make its identity reasonably distinct.

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

Usage Guidelines3/5

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

Usage context is only implied: an agent can infer that a free route gives a single top recommendation and paying $0.01 gives a ranked top-three, with tie-ins to ghost-bid pricing and receipt binding. However, there is no explicit 'when to use this versus the alternate router' guidance, and it does not mention alternatives such as route_task or mpp_route.

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.