Server data from the Official MCP Registry
Convert PDF/Word/Excel/PowerPoint documents to Markdown, paid in USDC via x402.
About
Convert PDF/Word/Excel/PowerPoint documents to Markdown, paid in USDC via x402.
Security Report
The server's core purpose (uploading documents to a paid conversion service) justifies its network and file access, and the wallet key is read from the environment and not hardcoded. However, estimate_conversion uploads the contents of any local file path to a remote server without payment or confirmation and with no path or type restriction, which could expose sensitive files if the agent is prompt-injected. The wallet key also carries spending authority, and the spend cap relies on a server-provided quote rather than a verified on-chain amount. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.
3 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: DOC_CONV_AGENT_PK
Environment variable: DOC_CONV_BASE_URL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-nicklee002e-docconv-mcp": {
"env": {
"DOC_CONV_AGENT_PK": "your-doc-conv-agent-pk-here",
"DOC_CONV_BASE_URL": "your-doc-conv-base-url-here"
},
"args": [
"docconv-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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 exceedsmax_usdc) and converts. Returns inlinemarkdownfor text documents, or adownloadUrl(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)
| Variable | Description | Default |
|---|---|---|
DOC_CONV_AGENT_PK | Private 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_URL | Doc_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.pdfto 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_documentspends real USDC. Usemax_usdcto cap per-call cost.
Links
- Service: https://converter.crepe.fund
- Agent API (OpenAPI): https://converter.crepe.fund/openapi.json
- x402 discovery: https://converter.crepe.fund/.well-known/x402.json
- Operator: CREPE Foundation
License
MIT © CREPE Foundation
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.