Skip to main content
Glama

Preflight check an x402 URL

preflight_check
Read-only

Live-check an x402 URL before paying it: valid challenge, real price, token, pay-to match. Sends one unpaid request to the URL and compares the answer with our records; the verdict is ok, caution or avoid. Costs $0.005 via x402.

Input Schema

NameRequiredDescriptionDefault
urlYesThe x402 endpoint you are about to pay
methodNoHTTP method of the paid call (default: the listing's method when the URL is listed, else GET)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / method / description
      Previous value: -"HTTP method of the paid call (default GET)"New value: +"HTTP method of the paid call (default: the listing's method when the URL is listed, else GET)"
  2. Changed1 schema field changed
    • addedInput schema / properties / method / description
      Added value: +"HTTP method of the paid call (default GET)"
  3. First observed

TDQS

A4.4/5.0
Behavior5/5

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

Annotations only cover the safety profile (readOnlyHint, destructiveHint=false). The description adds behavior well beyond that: it makes a live outbound request to the target, that request is unpaid, it cross-checks against stored records, it returns a verdict from an enumerated set (ok, caution, avoid), and — critically for a paid tool — it explicitly states the $0.005 cost via x402. That is exactly the extra context an agent needs to invoke it safely.

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?

Three dense sentences with zero filler: purpose and checks first, then mechanism and return verdict, then cost. The most decision-relevant facts (what it checks, that it is a live unpaid probe, and the price) are all front-loaded.

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

Completeness4/5

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

There is no output schema, and the description does step in by naming the verdict values, plus it covers the cost and network side effect. It stops short of describing what a caution/avoid verdict carries or how failures (e.g. unreachable URL) surface, leaving a small gap for a tool whose whole output is a judgment.

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 description coverage is 100% and both parameters (url, method) are already documented in the schema, including the method enum and its default logic, so the description is not required to compensate. It adds no parameter-level detail beyond what the schema provides, so the baseline 3 applies.

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?

States a specific verb (live-check) and resource (an x402 URL) and enumerates exactly what it verifies: valid challenge, real price, token, and pay-to match. The 'sends one unpaid request' framing clearly sets it apart from the listing-reading siblings like get_service_status or get_service_report, so an agent can tell what this does without opening either schema.

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

Usage Guidelines4/5

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

Gives clear context for when to use it: 'before paying,' i.e. as a pre-payment verification step. It does not name an explicit alternative or a when-not condition, so it stops short of the 5-level routing guidance, but the timing cue is unambiguous.

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