mcpField
D
Doc_Conv — Document to Markdown

Doc_Conv — Document to Markdown

Local
github.com/nicklee002eProductivity0Updated 2w ago
Repository

About Doc_Conv — Document to Markdown

Doc_Conv is an MCP server that converts PDF, Word, Excel, and PowerPoint files to Markdown for agents preparing documents for LLM use. It offers free price estimates and charges per conversion in USDC on Base through x402.

Key features

  1. 01Convert supported documents to Markdown
  2. 02Estimate conversion cost without payment
  3. 03Return Markdown or an image-containing ZIP
  4. 04Cap conversion spending with max_usdc

Use cases

  1. 01Prepare a PDF report for an LLM
  2. 02Convert Word or PowerPoint files before analysis
  3. 03Check the price before paying for conversion

MCP support

Exposes document price estimates and conversion through MCP tools. Conversion uses x402 payments in USDC on Base; estimates do not require payment or a wallet.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "nicklee002e-docconv": {
      "command": "uvx",
      "args": [
        "docconv-mcp"
      ],
      "env": {
        "DOC_CONV_AGENT_PK": "<DOC_CONV_AGENT_PK>",
        "DOC_CONV_BASE_URL": "<DOC_CONV_BASE_URL>"
      }
    }
  }
}
Run commanduvx docconv-mcp
Environment variables to set
DOC_CONV_AGENT_PKSecretPrivate key of the agent's Base wallet, used ONLY by convert_document to sign the x402 (EIP-3009) USDC payment. Leave unset to install and use estimate_conversion (free pricing) without a wallet. Secret - never commit or share.
DOC_CONV_BASE_URLBase URL of the Doc_Conv service. Defaults to the hosted service.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypidocconv-mcp1.0.2

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

docconv-mcp

MCP server for Doc_Conv — convert PDF / Word / Excel / PowerPoint documents to Markdown, paid per conversion with USDC on Base via the x402 protocol (gasless, EIP-3009). No account, no API key: the agent signs a USDC payment and the service returns Markdown.

Why? Feeding formatted files (PDF/PPT/DOCX) straight into an LLM can cost 5–50× more tokens than the same content as Markdown. This lets an agent cheaply pre-convert documents before use.

Tools

  • estimate_conversion(file_path) — free price quote (pages, credits, priceUsdc, jobId, jobToken). No payment, no side effects.
  • convert_document(file_path, max_usdc=1.0, poll_seconds=300) — pays via x402 (rejects if the quote exceeds max_usdc) and converts. Returns inline markdown for text documents, or a downloadUrl (zip) when the document contains images.

Try it without a wallet

Pricing is free and needs no key, no account, no wallet — install it and ask for a quote:

claude mcp add doc-conv -- uvx docconv-mcp

Then: "How much would it cost to convert ~/papers/report.pdf?" — the agent calls estimate_conversion and answers. Add a wallet only when you want an actual conversion.

Install

Published to PyPI as docconv-mcp. Run with uvx (no install) or pip install docconv-mcp.

Configuration (env)

VariableDescriptionDefault
DOC_CONV_AGENT_PKPrivate key of the agent's Base wallet (must hold USDC). Signs x402 payments. Needed only by convert_document — estimate_conversion works without it. Secret — never commit or share.(unset: pricing only)
DOC_CONV_BASE_URLDoc_Conv service base URL. Override only if self-hosting.https://converter.crepe.fund

The wallet needs USDC on Base; gas is paid by the service's x402 facilitator (the agent needs no ETH). Pricing is by document size: 50 pages = 1 credit = 0.2 USDC (call estimate_conversion for the exact amount).

Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json)

{
  "mcpServers": {
    "doc-conv": {
      "command": "uvx",
      "args": ["docconv-mcp"],
      "env": { "DOC_CONV_AGENT_PK": "0x<your-agent-wallet-private-key>" }
    }
  }
}

Claude Code one-liner:

claude mcp add doc-conv -- env DOC_CONV_AGENT_PK=0x<key> uvx docconv-mcp

Example

"Convert ~/papers/report.pdf to Markdown."

The agent calls estimate_conversion to see the price (e.g. 0.3 USDC), then convert_document to pay via x402 and return the Markdown. If conversion fails, the paid credit is retained on the payer wallet for reuse.

⚠️ convert_document spends real USDC. Use max_usdc to cap per-call cost.

Links

License

MIT © CREPE Foundation

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.