# Web Distillation with BM25 Budget Control

> Web Distillation with BM25 Budget Control is a paid API for AI agents from mcp-compiler.agentdiet.dev, paid per call via MPP, $0.001/call, status unknown (last checked 2026-10-23).

Fetches and distills a URL or raw HTML into Markdown, structured JSON, skeleton outline, or a BM25-focused token-budget excerpt

## Facts

- Endpoint: POST https://mcp-compiler.agentdiet.dev/v1/rag-chunk?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Provider: mcp-compiler.agentdiet.dev
- Website: https://mcp-compiler.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/mcp-compiler-agentdiet-dev-web-distillation-with-bm25-budget-control-25c01253
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_59X-W3-EARZFkQkL30VRW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mcp-compiler-agentdiet-dev-web-distillation-with-bm25-budget-control-25c01253 -d '<json body>'
```

Example prompt: Distill https://stripe.com/docs/payments into clean markdown with a 500-token budget, focusing on the query 'payment intents setup' using budget mode.

## When to prefer this

Choose this endpoint when you need to reduce token cost before passing web content to an LLM, especially for RAG pipelines or agent workflows where context window size matters. It is ideal when you have a specific focus query (BM25 mode) or need structured extraction (tables/metadata) from arbitrary URLs. Prefer it over raw fetch+parse when compression ratio and cost savings are important, or when you need a skeleton outline for navigation before deep reading.

## Known failure modes

- URL is unreachable or returns non-200 — distillation fails with fetch error
- Raw HTML is malformed or empty — parser returns minimal or empty output
- max_tokens set below content minimum — may return truncated or error response
- BM25 query not provided when mode=budget — may fall back to unfiltered budget trim
- Payment not included or insufficient — HTTP 402 returned blocking execution
- Rate limiting or timeout on remote URL — latency spike or failure

## How this service works

Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://mcp-compiler.agentdiet.dev/v1/rag-chunk)

## Output

Returns a status field, distilled data object (Markdown, structured JSON, skeleton, or BM25 excerpt depending on mode), an ROI proof block showing raw vs distilled token counts, compression ratio, and estimated LLM cost saved, plus optional cache hit/miss metadata and billing info.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mcp-compiler-agentdiet-dev-web-distillation-with-bm25-budget-control-25c01253/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp-compiler.agentdiet.dev](https://www.zero.xyz/host/mcp-compiler.agentdiet.dev/llms.txt)