# structdoc-mcp

MCP server for **StructDoc** — turn any document (PDF/image) into structured data for AI agents. OCR, layout-to-Markdown, tables, key-value pairs, invoice/receipt fields. 100+ languages. Pay per call with x402 (USDC on Base/Solana) — no API keys.

## Install

```bash
claude mcp add structdoc -e EVM_PRIVATE_KEY=0x<base-wallet-with-usdc> -- npx -y structdoc-mcp
```

Or configure any MCP client to run `npx -y structdoc-mcp` with env:

- `EVM_PRIVATE_KEY` — Base wallet private key holding USDC, **and/or**
- `SVM_PRIVATE_KEY` — Solana wallet private key (base58) holding USDC
- `STRUCTDOC_BASE_URL` (optional) — default `https://structdoc-api.hp-vladic.workers.dev`

## Tools

| Tool | Does | Price |
|---|---|---|
| `document_to_markdown` | Layout → Markdown (headings, tables, key-value). RAG-ready. ≤20p | $0.25 |
| `document_ocr` | OCR full-text, 100+ languages. ≤25p | $0.05 |
| `extract_invoice` | Invoice fields (vendor, items, totals). ≤4p | $0.08 |
| `extract_receipt` | Receipt fields (merchant, date, total). ≤2p | $0.04 |
| `document_ocr_large` | OCR up to 100 pages | $0.20 |
| `document_to_markdown_large` | Markdown up to 100 pages | $1.10 |
| `structdoc_catalog` | Free machine-readable catalog | free |

Each tool takes `{ url }` or `{ base64 }` (PDF/JPEG/PNG/BMP/TIFF/HEIF).

Engine: Azure Document Intelligence v4.0. API: https://structdoc-api.hp-vladic.workers.dev

MIT