Doc_Conv — Document to Markdown

io.github.nicklee002ePublished by GitHub account nicklee002ev1.0.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFiles & StorageFinance

Overview

AI-generated overview

Converts PDF, Word, Excel and PowerPoint files to Markdown, quoting prices for free and paying per conversion in USDC on Base via x402.

What you can do
  • Quote a document conversion: estimate pages, credits and USDC price for a local file, free and without a wallet.
  • Convert documents: pay the quoted amount via x402 and get Markdown inline, or a zip download link when the file contains images.
  • Cap spending: set a maximum USDC amount per conversion call, with quotes above it rejected.
When to use it
Useful when an assistant needs to read formatted PDF, DOCX, XLSX or PPTX files and Markdown would be far cheaper in tokens than the original. Try the free quote first; add a funded wallet only when you actually want conversions.
Requirements
Runs locally as a PyPI package (docconv-mcp) via uvx or pip, on desktop only. estimate_conversion needs no account or key. convert_document needs DOC_CONV_AGENT_PK, the private key of a Base wallet holding USDC; DOC_CONV_BASE_URL optionally overrides the hosted service URL. Network access to the Doc_Conv service.
Before you install
convert_document spends real USDC from the wallet whose private key is in DOC_CONV_AGENT_PK, so keep that key secret and never commit it. Use max_usdc to cap per-call cost. Document contents are sent to the hosted third-party service (CREPE Foundation) for conversion. Failed conversions keep the paid credit on the payer wallet.

Installation

In SourceWeft

  1. Open Doc_Conv — Document to Markdown in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

bash
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)

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

Claude Code one-liner:

bash
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

Source: README.md at commit e81916f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v1.0.2LatestOct 18, 2026
  2. v1.0.1Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts