{"uid":"cap_GaFT8JzV66S4NLVEErf9x","slug":"mcp-security-agentdiet-dev-url-to-markdown-web-distiller-f4d1ee11","name":"URL to Markdown Web Distiller","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://mcp-security.agentdiet.dev/v1/url-to-markdown)","url":"https://mcp-security.agentdiet.dev/v1/url-to-markdown?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","minLength":1,"description":"Target webpage URL to fetch and distill (or builtin://stripe-docs)"},"html":{"type":"string","description":"Optional raw HTML string to distill directly without fetching"},"mode":{"enum":["markdown","structured","skeleton","budget"],"type":"string","default":"markdown","description":"Distillation mode"},"query":{"type":"string","description":"BM25 focus query when mode=budget"},"max_tokens":{"type":"integer","minimum":20,"description":"Strict token budget ceiling when mode=budget"}}},"responseSchema":{"type":"object","required":["status","roi_proof","data"],"properties":{"data":{"type":"object","description":"Distilled Markdown, structured JSON tables/metadata, skeleton outline, or BM25 budget excerpt."},"cache":{"type":"object","properties":{"status":{"enum":["HIT","MISS"],"type":"string"},"cache_key":{"type":"string"},"latency_ms":{"type":"number"}}},"status":{"type":"string","description":"Execution status ('ok')"},"billing":{"type":"object","properties":{"agent_id":{"type":"string"},"payment_method":{"type":"string"},"fee_charged_usd":{"type":"number"}}},"roi_proof":{"type":"object","properties":{"raw_tokens":{"type":"integer"},"tokens_saved":{"type":"integer"},"roi_multiplier":{"type":"number"},"distilled_tokens":{"type":"integer"},"llm_cost_saved_usd":{"type":"number"},"compression_ratio_pct":{"type":"number"}}}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.001","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XhRlzfxwHqUSDdVVH6Kdu","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"mcp-security.agentdiet.dev","brandSlug":"mcp-security-agentdiet-dev-mpp","brandBaseUrl":"https://mcp-security.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a webpage URL (or accepts raw HTML) and distills it into compact, token-efficient Markdown, structured JSON, skeleton outline, or BM25-focused budget excerpt for AI agents","exampleAgentPrompt":"Fetch the page at https://stripe.com/docs/payments and distill it into compact markdown, keeping it under 500 tokens and focusing on the query 'payment intents'.","exampleUseCases":[{"title":"Token-budget research on docs page","prompt":"Pull the OpenAI API reference page at https://platform.openai.com/docs/api-reference and compress it into under 300 tokens using budget mode, focused on the query 'function calling'."},{"title":"Structured data extraction from landing page","prompt":"Grab https://www.anthropic.com/product and return the content as structured JSON tables so I can see pricing tiers and feature comparisons clearly."},{"title":"Skeleton outline of a long article","prompt":"Distill https://en.wikipedia.org/wiki/Large_language_model into a skeleton outline so I can quickly understand its section headings and key topics without reading the whole thing."}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (Markdown text, structured JSON, skeleton outline, or BM25-focused excerpt depending on mode), plus an 'roi_proof' object showing raw token count, distilled token count, tokens saved, compression ratio percentage, ROI multiplier, and estimated LLM cost saved in USD. Also includes optional cache hit/miss status and billing details.","failureModes":["URL is unreachable or returns non-200 HTTP status — endpoint may return an error status","URL points to a PDF or binary file not parseable as HTML — unstructured content may produce poor distillation","max_tokens set too low (below 20) — request rejected by schema validation","BM25 query provided without mode=budget — query parameter ignored silently","Raw HTML provided via 'html' parameter is malformed — distillation quality may degrade","Payment not completed via x402 — 402 Payment Required response blocks execution"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read or process web page content while minimizing token consumption and LLM costs. It is especially valuable when working with long documentation pages, news articles, or HTML-heavy sites where raw content would exceed context windows. The BM25 budget mode is ideal when only a topically relevant excerpt is needed. Prefer this over generic HTTP fetch tools when token efficiency, structured output (tables, skeleton), or cost ROI tracking is a priority.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T15:01:49.907Z","isFirstParty":false,"canonicalSlug":"mcp-security-agentdiet-dev-url-to-markdown-web-distiller-f4d1ee11"}