{
  "markdown": "# docconv-mcp\n\n<!-- mcp-name: io.github.nicklee002e/docconv-mcp -->\n\nMCP server for **[Doc_Conv](https://converter.crepe.fund)** — convert PDF / Word / Excel /\nPowerPoint documents to **Markdown**, paid **per conversion with USDC on Base** via the\n[x402](https://x402.org) protocol (gasless, EIP-3009). No account, no API key: the agent signs a\nUSDC payment and the service returns Markdown.\n\nWhy? Feeding formatted files (PDF/PPT/DOCX) straight into an LLM can cost **5–50× more tokens**\nthan the same content as Markdown. This lets an agent cheaply pre-convert documents before use.\n\n## Tools\n\n- **`estimate_conversion(file_path)`** — free price quote (`pages`, `credits`, `priceUsdc`,\n  `jobId`, `jobToken`). No payment, no side effects.\n- **`convert_document(file_path, max_usdc=1.0, poll_seconds=300)`** — pays via x402 (rejects if the\n  quote exceeds `max_usdc`) and converts. Returns inline `markdown` for text documents, or a\n  `downloadUrl` (zip) when the document contains images.\n\n## Install\n\nPublished to PyPI as [`docconv-mcp`](https://pypi.org/project/docconv-mcp/). Run with\n[`uvx`](https://docs.astral.sh/uv/) (no install) or `pip install docconv-mcp`.\n\n## Configuration (env)\n\n| Variable | Description | Default |\n|---|---|---|\n| `DOC_CONV_AGENT_PK` | Private key of the agent's **Base wallet** (must hold USDC). Signs x402 payments. **Secret — never commit or share.** | *(required)* |\n| `DOC_CONV_BASE_URL` | Doc_Conv service base URL. Override only if self-hosting. | `https://converter.crepe.fund` |\n\nThe wallet needs **USDC on Base**; gas is paid by the service's x402 facilitator (the agent needs\nno ETH). Pricing is by document size: 50 pages = 1 credit = 0.2 USDC (call `estimate_conversion`\nfor the exact amount).\n\n## Claude Desktop / Claude Code (`claude_desktop_config.json` or `.mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"doc-conv\": {\n      \"command\": \"uvx\",\n      \"args\": [\"docconv-mcp\"],\n      \"env\": { \"DOC_CONV_AGENT_PK\": \"0x<your-agent-wallet-private-key>\" }\n    }\n  }\n}\n```\n\nClaude Code one-liner:\n\n```bash\nclaude mcp add doc-conv -- env DOC_CONV_AGENT_PK=0x<key> uvx docconv-mcp\n```\n\n## Example\n\n> \"Convert `~/papers/report.pdf` to Markdown.\"\n\nThe agent calls `estimate_conversion` to see the price (e.g. 0.3 USDC), then `convert_document` to\npay via x402 and return the Markdown. If conversion fails, the paid credit is retained on the payer\nwallet for reuse.\n\n> ⚠️ `convert_document` spends real USDC. Use `max_usdc` to cap per-call cost.\n\n## Links\n\n- Service: https://converter.crepe.fund\n- Agent API (OpenAPI): https://converter.crepe.fund/openapi.json\n- x402 discovery: https://converter.crepe.fund/.well-known/x402.json\n- Operator: [CREPE Foundation](https://crepe.fund)\n\n## License\n\nMIT © CREPE Foundation\n",
  "bytes": 2751,
  "sha": "b9546f4dc9fb8c2cf1765a971e91f3d7de14e9a6ecd7ce8a6115218494e38fcd",
  "repo_slug": "nicklee002e/docconv-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nicklee002e_docconv_mcp_2e222476/readme"
}