KlearFlow Relay

Route Task

route_task

Read-only

Use this when the caller needs to discover and rank live x402 providers for a task before choosing downstream spend. KlearFlow does not execute the selected provider. Routing costs $0.005 via x402 Base USDC.

Input Schema

TableJSON Schema

Name	Required	Description
`task`	Yes	Plain-English capability the caller wants a live x402 provider to perform.
`limit`	No	Maximum number of ranked provider candidates to return.
`maxPriceUsd`	No	Optional maximum listed provider price in USD.
`excludeHosts`	No	Optional provider hostnames to exclude from the ranked result, useful to avoid self-routing or previously rejected providers.
`preferPaidVerified`	No	When true, rank providers with independent paid-verification evidence higher.

Output Schema

TableJSON Schema

Name	Required	Description
`result`	Yes	Routing result containing the ranked live x402 provider candidates and the selected recommendation; no downstream provider is executed.
`payment`	Yes
`proofId`	Yes	Unique KlearFlow proof identifier for this settled paid execution.
`priceUsd`	Yes	USDC-denominated execution price settled through x402.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 9, 2026

addedInput schema / properties / excludeHosts / description

Added value: +"Optional provider hostnames to exclude from the ranked result, useful to avoid self-routing or previously rejected providers."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "payment": {
+      "additionalProperties": false,
+      "properties": {
+        "network": {
+          "description": "Payment network identifier, currently Base mainnet eip155:8453.",
+          "type": "string"
+        },
+        "payer": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Settled payer address when supplied by the payment facilitator."
+        },
+        "protocol": {
+          "const": "x402",
+          "type": "string"
+        },
+        "transaction": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Settlement transaction identifier when available."
+        }
+      },
+      "required": [
+        "protocol",
+        "payer",
+        "transaction",
+        "network"
+      ],
+      "type": "object"
+    },
+    "priceUsd": {
+      "description": "USDC-denominated execution price settled through x402.",
+      "minimum": 0,
+      "type": "number"
+    },
+    "proofId": {
+      "description": "Unique KlearFlow proof identifier for this settled paid execution.",
+      "type": "string"
+    },
+    "result": {
+      "additionalProperties": true,
+      "description": "Routing result containing the ranked live x402 provider candidates and the selected recommendation; no downstream provider is executed.",
+      "type": "object"
+    }
+  },
+  "required": [
+    "proofId",
+    "priceUsd",
+    "payment",
+    "result"
+  ],
+  "type": "object"
+}

Changed4 schema fields changedOct 5, 2026

addedInput schema / properties / limit / description

Added value: +"Maximum number of ranked provider candidates to return."

addedInput schema / properties / maxPriceUsd / description

Added value: +"Optional maximum listed provider price in USD."

addedInput schema / properties / preferPaidVerified / description

Added value: +"When true, rank providers with independent paid-verification evidence higher."

addedInput schema / properties / task / description

Added value: +"Plain-English capability the caller wants a live x402 provider to perform."

Changed3 schema fields changedSep 30, 2026

addedInput schema / properties / excludeHosts

Added value: +{
+  "items": {
+    "maxLength": 255,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 20,
+  "type": "array"
+}

addedInput schema / properties / maxPriceUsd

Added value: +{
+  "maximum": 1000,
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / properties / preferPaidVerified
```
Added value: +{
+  "type": "boolean"
+}
```

AddedSep 29, 2026

TDQS

Score is being calculated.

All KlearFlow Relay 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?