PubFi MCP

pubfi.route.execute

Destructive

Execute one exact GET or POST path through the authenticated PubFi account lane and the same Registry v2 matcher and typed executor as the HTTP gateway. Append :free only when the capability catalog publishes that exact account-scoped free variant.

Input Schema

TableJSON Schema

Name	Required	Description
`body`	No	Exact optional ASCII request-body bytes. For JSON routes, supply one compact serialized JSON document rather than a nested MCP argument value.
`query`	No	Exact ASCII raw query string without a leading question mark.
`method`	Yes
`raw_path`	Yes	Exact original URI path consumed by the Registry matcher. Segments use canonical unreserved ASCII only; percent escapes, dot segments, query, fragment, and backslash are forbidden.
`request_id`	No
`idempotency_key`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedAug 21, 2026

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "credits_charged": {
-        "const": 0
-      },
-      "execution_authority": {
-        "const": "typed_gateway_registry_v2"
-      },
-      "execution_status": {
-        "const": "registry_free_route_executed"
-      },
-      "generation": {
-        "type": "object"
-      },
-      "ok": {
-        "const": true
-      },
-      "provider": {
-        "type": "object"
-      },
-      "route": {
-        "type": "object"
-      },
-      "upstream": {
-        "type": "object"
-      },
-      "upstream_response": {
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "execution_status",
-      "execution_authority",
-      "generation",
-      "route",
-      "provider",
-      "upstream",
-      "credits_charged",
-      "upstream_response"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "credits_charged": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "execution_authority": {
-        "const": "typed_gateway_registry_v2"
-      },
-      "execution_status": {
-        "const": "registry_route_executed"
-      },
-      "generation": {
-        "type": "object"
-      },
-      "ok": {
-        "const": true
-      },
-      "provider": {
-        "type": "object"
-      },
-      "route": {
-        "type": "object"
-      },
-      "upstream": {
-        "type": "object"
-      },
-      "upstream_response": {
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "execution_status",
-      "execution_authority",
-      "generation",
-      "route",
-      "provider",
-      "upstream",
-      "credits_charged",
-      "upstream_response"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "execution_authority": {
-        "const": "typed_gateway_registry_v2"
-      },
-      "execution_status": {
-        "const": "x402_registry_route_executed"
-      },
-      "ok": {
-        "const": true
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "lane": {
-            "const": "accountless_x402"
-          }
-        },
-        "required": [
-          "lane"
-        ],
-        "type": "object"
-      },
-      "upstream_response": {
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "execution_status",
-      "execution_authority",
-      "payment",
-      "upstream_response"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "billing": {
+        "additionalProperties": false,
+        "properties": {
+          "mode": {
+            "const": "free_health"
+          }
+        },
+        "required": [
+          "mode"
+        ],
+        "type": "object"
+      },
+      "execution_authority": {
+        "const": "typed_gateway_registry_v2"
+      },
+      "execution_status": {
+        "const": "free_health_executed"
+      },
+      "generation": {
+        "type": "object"
+      },
+      "ok": {
+        "const": true
+      },
+      "provider": {
+        "type": "object"
+      },
+      "route": {
+        "type": "object"
+      },
+      "upstream": {
+        "type": "object"
+      },
+      "upstream_response": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "execution_status",
+      "execution_authority",
+      "billing",
+      "generation",
+      "route",
+      "provider",
+      "upstream",
+      "upstream_response"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "credits_charged": {
+        "const": 0
+      },
+      "execution_authority": {
+        "const": "typed_gateway_registry_v2"
+      },
+      "execution_status": {
+        "const": "registry_free_route_executed"
+      },
+      "generation": {
+        "type": "object"
+      },
+      "ok": {
+        "const": true
+      },
+      "provider": {
+        "type": "object"
+      },
+      "route": {
+        "type": "object"
+      },
+      "upstream": {
+        "type": "object"
+      },
+      "upstream_response": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "execution_status",
+      "execution_authority",
+      "generation",
+      "route",
+      "provider",
+      "upstream",
+      "credits_charged",
+      "upstream_response"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "credits_charged": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "execution_authority": {
+        "const": "typed_gateway_registry_v2"
+      },
+      "execution_status": {
+        "const": "registry_route_executed"
+      },
+      "generation": {
+        "type": "object"
+      },
+      "ok": {
+        "const": true
+      },
+      "provider": {
+        "type": "object"
+      },
+      "route": {
+        "type": "object"
+      },
+      "upstream": {
+        "type": "object"
+      },
+      "upstream_response": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "execution_status",
+      "execution_authority",
+      "generation",
+      "route",
+      "provider",
+      "upstream",
+      "credits_charged",
+      "upstream_response"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedAug 8, 2026

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "credits_charged": {
-        "const": 1
-      },
-      "execution_authority": {
-        "const": "typed_gateway_registry_v2"
-      },
-      "execution_status": {
-        "const": "registry_route_executed"
-      },
-      "generation": {
-        "type": "object"
-      },
-      "ok": {
-        "const": true
-      },
-      "provider": {
-        "type": "object"
-      },
-      "route": {
-        "type": "object"
-      },
-      "upstream": {
-        "type": "object"
-      },
-      "upstream_response": {
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "execution_status",
-      "execution_authority",
-      "generation",
-      "route",
-      "provider",
-      "upstream",
-      "credits_charged",
-      "upstream_response"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "execution_authority": {
-        "const": "typed_gateway_registry_v2"
-      },
-      "execution_status": {
-        "const": "x402_registry_route_executed"
-      },
-      "ok": {
-        "const": true
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "lane": {
-            "const": "accountless_x402"
-          }
-        },
-        "required": [
-          "lane"
-        ],
-        "type": "object"
-      },
-      "upstream_response": {
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "execution_status",
-      "execution_authority",
-      "payment",
-      "upstream_response"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "credits_charged": {
+        "const": 0
+      },
+      "execution_authority": {
+        "const": "typed_gateway_registry_v2"
+      },
+      "execution_status": {
+        "const": "registry_free_route_executed"
+      },
+      "generation": {
+        "type": "object"
+      },
+      "ok": {
+        "const": true
+      },
+      "provider": {
+        "type": "object"
+      },
+      "route": {
+        "type": "object"
+      },
+      "upstream": {
+        "type": "object"
+      },
+      "upstream_response": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "execution_status",
+      "execution_authority",
+      "generation",
+      "route",
+      "provider",
+      "upstream",
+      "credits_charged",
+      "upstream_response"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "credits_charged": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "execution_authority": {
+        "const": "typed_gateway_registry_v2"
+      },
+      "execution_status": {
+        "const": "registry_route_executed"
+      },
+      "generation": {
+        "type": "object"
+      },
+      "ok": {
+        "const": true
+      },
+      "provider": {
+        "type": "object"
+      },
+      "route": {
+        "type": "object"
+      },
+      "upstream": {
+        "type": "object"
+      },
+      "upstream_response": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "execution_status",
+      "execution_authority",
+      "generation",
+      "route",
+      "provider",
+      "upstream",
+      "credits_charged",
+      "upstream_response"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "execution_authority": {
+        "const": "typed_gateway_registry_v2"
+      },
+      "execution_status": {
+        "const": "x402_registry_route_executed"
+      },
+      "ok": {
+        "const": true
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "lane": {
+            "const": "accountless_x402"
+          }
+        },
+        "required": [
+          "lane"
+        ],
+        "type": "object"
+      },
+      "upstream_response": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "execution_status",
+      "execution_authority",
+      "payment",
+      "upstream_response"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedJul 30, 2026

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "execution_authority": {
-        "const": "typed_gateway_registry_v2"
-      },
-      "execution_status": {
-        "const": "registry_route_executed"
-      },
-      "generation": {
-        "type": "object"
-      },
-      "metering": {
-        "type": "object"
-      },
-      "ok": {
-        "const": true
-      },
-      "provider": {
-        "type": "object"
-      },
-      "route": {
-        "type": "object"
-      },
-      "upstream": {
-        "type": "object"
-      },
-      "upstream_response": {
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "execution_status",
-      "execution_authority",
-      "generation",
-      "route",
-      "provider",
-      "upstream",
-      "metering",
-      "upstream_response"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "execution_authority": {
-        "const": "typed_gateway_registry_v2"
-      },
-      "execution_status": {
-        "const": "x402_registry_route_executed"
-      },
-      "ok": {
-        "const": true
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "lane": {
-            "const": "accountless_x402"
-          }
-        },
-        "required": [
-          "lane"
-        ],
-        "type": "object"
-      },
-      "upstream_response": {
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "execution_status",
-      "execution_authority",
-      "payment",
-      "upstream_response"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "credits_charged": {
+        "const": 1
+      },
+      "execution_authority": {
+        "const": "typed_gateway_registry_v2"
+      },
+      "execution_status": {
+        "const": "registry_route_executed"
+      },
+      "generation": {
+        "type": "object"
+      },
+      "ok": {
+        "const": true
+      },
+      "provider": {
+        "type": "object"
+      },
+      "route": {
+        "type": "object"
+      },
+      "upstream": {
+        "type": "object"
+      },
+      "upstream_response": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "execution_status",
+      "execution_authority",
+      "generation",
+      "route",
+      "provider",
+      "upstream",
+      "credits_charged",
+      "upstream_response"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "execution_authority": {
+        "const": "typed_gateway_registry_v2"
+      },
+      "execution_status": {
+        "const": "x402_registry_route_executed"
+      },
+      "ok": {
+        "const": true
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "lane": {
+            "const": "accountless_x402"
+          }
+        },
+        "required": [
+          "lane"
+        ],
+        "type": "object"
+      },
+      "upstream_response": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "execution_status",
+      "execution_authority",
+      "payment",
+      "upstream_response"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedJul 29, 2026

removedInput schema / x-pubfi-registry-routes

Removed value: -[
-  {
-    "capability_id": "route-69e21b38524093d835a677f6a5122a2c177f050dfc297eb03a1858b07e2a3aa6",
-    "matcher": {
-      "kind": "exact",
-      "path": "/v1/gateway/quantro/health"
-    },
-    "methods": [
-      "GET"
-    ],
-    "readiness": {
-      "status": "ready"
-    },
-    "route": {
-      "id": "route-69e21b38524093d835a677f6a5122a2c177f050dfc297eb03a1858b07e2a3aa6",
-      "revision": 1
-    }
-  }
-]

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "oneOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "execution_authority": {
+          "const": "typed_gateway_registry_v2"
+        },
+        "execution_status": {
+          "const": "registry_route_executed"
+        },
+        "generation": {
+          "type": "object"
+        },
+        "metering": {
+          "type": "object"
+        },
+        "ok": {
+          "const": true
+        },
+        "provider": {
+          "type": "object"
+        },
+        "route": {
+          "type": "object"
+        },
+        "upstream": {
+          "type": "object"
+        },
+        "upstream_response": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "ok",
+        "execution_status",
+        "execution_authority",
+        "generation",
+        "route",
+        "provider",
+        "upstream",
+        "metering",
+        "upstream_response"
+      ],
+      "type": "object"
+    },
+    {
+      "additionalProperties": false,
+      "properties": {
+        "execution_authority": {
+          "const": "typed_gateway_registry_v2"
+        },
+        "execution_status": {
+          "const": "x402_registry_route_executed"
+        },
+        "ok": {
+          "const": true
+        },
+        "payment": {
+          "additionalProperties": false,
+          "properties": {
+            "lane": {
+              "const": "accountless_x402"
+            }
+          },
+          "required": [
+            "lane"
+          ],
+          "type": "object"
+        },
+        "upstream_response": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "ok",
+        "execution_status",
+        "execution_authority",
+        "payment",
+        "upstream_response"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}

Changed1 schema field changedJul 24, 2026

changedInput schema / x-pubfi-registry-routes

Previous value: -[]New value: +[
+  {
+    "capability_id": "route-69e21b38524093d835a677f6a5122a2c177f050dfc297eb03a1858b07e2a3aa6",
+    "matcher": {
+      "kind": "exact",
+      "path": "/v1/gateway/quantro/health"
+    },
+    "methods": [
+      "GET"
+    ],
+    "readiness": {
+      "status": "ready"
+    },
+    "route": {
+      "id": "route-69e21b38524093d835a677f6a5122a2c177f050dfc297eb03a1858b07e2a3aa6",
+      "revision": 1
+    }
+  }
+]

Changed18 schema fields changedJul 21, 2026

changedInput schema / additionalProperties
```
Previous value: -trueNew value: +false
```

removedInput schema / properties / arguments

Removed value: -{
-  "description": "Capability-specific execution arguments such as wallet address and network.",
-  "type": "object"
-}

addedInput schema / properties / body

Added value: +{
+  "description": "Exact optional ASCII request-body bytes. For JSON routes, supply one compact serialized JSON document rather than a nested MCP argument value.",
+  "maxLength": 1048576,
+  "pattern": "^[\\x20-\\x7E]*$",
+  "type": "string"
+}

removedInput schema / properties / idempotency_key / description

Removed value: -"Optional caller-provided idempotency key for execution."

addedInput schema / properties / idempotency_key / maxLength
```
Added value: +256
```
addedInput schema / properties / idempotency_key / minLength
```
Added value: +1
```
addedInput schema / properties / idempotency_key / pattern
```
Added value: +"^[\\x20-\\x7E]+$"
```

addedInput schema / properties / method

Added value: +{
+  "enum": [
+    "GET",
+    "POST"
+  ],
+  "type": "string"
+}

addedInput schema / properties / query

Added value: +{
+  "description": "Exact ASCII raw query string without a leading question mark.",
+  "maxLength": 65536,
+  "pattern": "^(?!\\?)[\\x20-\\x7E]*$",
+  "type": "string"
+}

addedInput schema / properties / raw_path

Added value: +{
+  "description": "Exact original URI path consumed by the Registry matcher. Segments use canonical unreserved ASCII only; percent escapes, dot segments, query, fragment, and backslash are forbidden.",
+  "maxLength": 2048,
+  "minLength": 2,
+  "pattern": "^/(?!\\.{1,2}(?:/|$))[A-Za-z0-9._~-]{1,128}(?:/(?!\\.{1,2}(?:/|$))[A-Za-z0-9._~-]{1,128}){0,63}$",
+  "type": "string"
+}

removedInput schema / properties / request_id / description

Removed value: -"Optional caller-provided request id for tracing."

addedInput schema / properties / request_id / maxLength
```
Added value: +256
```
addedInput schema / properties / request_id / minLength
```
Added value: +1
```
addedInput schema / properties / request_id / pattern
```
Added value: +"^[\\x20-\\x7E]+$"
```

removedInput schema / properties / route_id

Removed value: -{
-  "description": "Capability route id selected by pubfi.route.plan.",
-  "pattern": "^capability:",
-  "type": "string"
-}

removedInput schema / properties / route_plan

Removed value: -{
-  "description": "Route-planning evidence returned by pubfi.route.plan.",
-  "type": "object"
-}

changedInput schema / required

Previous value: -[
-  "route_id",
-  "route_plan",
-  "arguments"
-]New value: +[
+  "raw_path",
+  "method"
+]

addedInput schema / x-pubfi-registry-routes
```
Added value: +[]
```

Changed2 schema fields changedJul 3, 2026

addedInput schema / properties

Added value: +{
+  "arguments": {
+    "description": "Capability-specific execution arguments such as wallet address and network.",
+    "type": "object"
+  },
+  "idempotency_key": {
+    "description": "Optional caller-provided idempotency key for execution.",
+    "type": "string"
+  },
+  "request_id": {
+    "description": "Optional caller-provided request id for tracing.",
+    "type": "string"
+  },
+  "route_id": {
+    "description": "Capability route id selected by pubfi.route.plan.",
+    "pattern": "^capability:",
+    "type": "string"
+  },
+  "route_plan": {
+    "description": "Route-planning evidence returned by pubfi.route.plan.",
+    "type": "object"
+  }
+}

addedInput schema / required

Added value: +[
+  "route_id",
+  "route_plan",
+  "arguments"
+]

First observedJun 29, 2026

TDQS

C2.8/5.0

Behavior3/5

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

Annotations indicate destructiveHint=true and idempotentHint=false, which the description does not contradict. The description mentions 'execute' and a conditional 'Append :free' behavior, adding some transparency beyond the annotations. However, it does not describe side effects, idempotency implications, or what happens on failure, leaving gaps in understanding the full behavioral impact.

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

Conciseness3/5

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

The description is concise but dense, using jargon and a single complex sentence. It is not broken into clear parts and lacks a structured presentation of the tool's behavior and nuances. While not verbose, it sacrifices clarity for brevity.

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?

The description leaves out critical contextual details: it does not mention expected return values, error handling, or how the conditional free variant affects the request or response. Given the tool's apparent complexity (route execution, account scoping, conditional behavior), the description is insufficient for an agent to predict outcomes reliably beyond the basic execution.

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

Parameters2/5

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

The schema provides descriptions for some parameters (body, query, raw_path), but the tool description does not explain any parameter semantics itself. It only mentions the overall execution behavior, not how the parameters like method, request_id, or idempotency_key are used. The schema coverage is partial, and the description adds no parameter-level detail, making it hard for an agent to construct a correct request.

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 it executes a GET or POST path through an authenticated account lane, using the same matcher/executor as the HTTP gateway. This conveys the core purpose, though it relies on domain-specific jargon like 'PubFi account lane' and 'Registry v2 matcher.' It is distinguishable from the sibling read-only tools, which are for capabilities.

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

Usage Guidelines2/5

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

The description provides only conditional guidance ('Append :free only when the capability catalog publishes that exact account-scoped free variant') but does not explain when to choose this tool over alternatives or when not to use it. There is no explicit when/when-not context, leaving the decision largely to the agent's interpretation.

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

All PubFi MCP 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?