English Français العربية

Doc_Conv — Document to Markdown

Official registry Productivity

Convert PDF/Word/Excel/PowerPoint documents to Markdown, paid in USDC via x402.

Source code Documentation

What can you do with Doc_Conv — Document to Markdown?

  • estimate_conversion(file_path) — free price quote (pages, credits, priceUsdc,
  • convert_document(file_path, max_usdc=1.0, poll_seconds=300) — pays via x402 (rejects if the

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package docconv-mcp
Claude Code 
claude mcp add doc-conv-document-to-markdown -e 'DOC_CONV_AGENT_PK=<your doc_conv_agent_pk>' -e 'DOC_CONV_BASE_URL=https://converter.crepe.fund' -- uvx docconv-mcp==1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "doc-conv-document-to-markdown": {
            "command": "uvx",
            "args": [
                "docconv-mcp==1.0.2"
            ],
            "env": {
                "DOC_CONV_AGENT_PK": "<your doc_conv_agent_pk>",
                "DOC_CONV_BASE_URL": "https://converter.crepe.fund"
            }
        }
    }
}

Environment variables

  • DOC_CONV_AGENT_PK secret Private 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_URL Base URL of the Doc_Conv service. Defaults to the hosted service.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. docconv-mcp
  2. Tools
  3. Try it without a wallet
  4. Install
  5. Configuration (env)
  6. Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json)
  7. Example
  8. Links
  9. License

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.

License

MIT © CREPE Foundation

Frequently asked questions

What is Doc_Conv — Document to Markdown?

Convert PDF/Word/Excel/PowerPoint documents to Markdown, paid in USDC via x402.

How do I install Doc_Conv — Document to Markdown?

It runs on your machine. In Claude Code: claude mcp add doc-conv-document-to-markdown -e 'DOC_CONV_AGENT_PK=<your doc_conv_agent_pk>' -e 'DOC_CONV_BASE_URL=https://converter.crepe.fund' -- uvx docconv-mcp==1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Doc_Conv — Document to Markdown need an API key?

Yes. It expects DOC_CONV_AGENT_PK, which you set in its configuration.

Is Doc_Conv — Document to Markdown open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Doc_Conv — Document to Markdown?

It is published by nicklee002e. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.