# AgentDiet Docs-to-Markdown Converter

> AgentDiet Docs-to-Markdown Converter is a paid API for AI agents from rag-diet.agentdiet.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-22).

Fetches a document URL and converts its content to clean, token-efficient Markdown, achieving up to 91%+ compression ratio for AI context windows.

## Facts

- Endpoint: GET https://rag-diet.agentdiet.dev/v1/docs-to-markdown?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentdiet-docs-to-markdown-converter-864a172d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3EV5UEWOpmG_5C4ZxzqfD

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 agentdiet-docs-to-markdown-converter-864a172d
```

Example prompt: Fetch the docs page at https://docs.example.com/api-reference and convert it to clean Markdown so I can use it in my context window without burning tokens.

## When to prefer this

Choose this endpoint when you need to feed web documents or documentation pages into an AI agent's context window and want to minimize token usage. It is ideal for RAG pipelines, agent memory ingestion, and any workflow where HTML bloat is a problem. Prefer it over generic web scrapers when compression ratio and Markdown fidelity for LLM consumption are the primary goals.

## Known failure modes

- Invalid or unreachable URL returns an error status
- URL points to non-text content (PDF binary, image) may yield empty or malformed markdown
- Rate limiting or payment failure (x402) blocks the request
- Paywalled or JS-rendered pages may not be fully accessible
- Malformed input schema (missing required 'type' or 'method') returns a validation error

## How this service works

Deterministic B2A/A2A/MCP/x402/MPP/L402 execution and intelligence node at https://rag-diet.agentdiet.dev settling in USDC on Base.

## Output

Returns a JSON object with a 'data' field containing the converted Markdown content, a 'status' field ('ok' on success), and an 'roi_proof' object showing the compression_ratio_pct (e.g. 91.4%), confirming how much token bloat was removed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "url": {
       "type": "string"
      },
      "mode": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "status": "ok",
  "roi_proof": {
   "compression_ratio_pct": 91.4
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentdiet-docs-to-markdown-converter-864a172d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rag-diet.agentdiet.dev](https://www.zero.xyz/host/rag-diet.agentdiet.dev/llms.txt)