Skip to main content
Glama

x402 Agent Hub

extract_clean_markdown

Fetch any public webpage and convert it into clean, token-efficient LLM Markdown with metadata and token count ($0.005 USDC on Base).

Input Schema

NameRequiredDescriptionDefault
urlYesPublic http/https URL to convert to Markdown
maxCharsNoMaximum Markdown characters (500-50000)
paymentSignatureNoOptional x402 v2 base64 PAYMENT-SIGNATURE

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior3/5

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

No annotations exist, so the description carries the full burden. It usefully discloses the cost and payment rail ($0.005 USDC on Base, x402), but says nothing about failure modes: paywalled/JS-rendered pages, timeouts, rate limits, or what happens when payment is missing or invalid.

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?

One dense sentence that front-loads the action, the resource, and the output contract, with the pricing caveat last. No filler.

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

Completeness3/5

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

With no output schema, the description does name the return payload (Markdown, metadata, token count), which is good. But for a paid x402 endpoint the payment flow is the riskiest part of invocation and is left unexplained, and nothing covers behavior on unfetchable pages.

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

Parameters4/5

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

Schema coverage is 100%, so baseline is 3; the description adds real meaning by explaining the monetary cost behind the paymentSignature parameter and the economic rationale for maxChars ("token-efficient"). It still doesn't explain the payment handshake (e.g., whether an unpaid call returns a 402 challenge).

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?

States a concrete verb chain (fetch a public webpage, convert to Markdown) plus the output qualities (metadata, token count). Sibling tools are unrelated domains, so no differentiation is needed, but it also doesn't explicitly bound itself against any other fetch/convert capability.

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?

"Any public webpage" implies the only stated precondition (publicly reachable, non-authenticated pages), but there is no explicit when-to-use, when-not-to-use, or alternative guidance. The agent must infer that this is for turning web content into LLM-consumable text.

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.