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 implements proper authentication via environment variable-based private key management for x402 USDC payments, and code quality is generally sound with appropriate error handling. However, there are moderate concerns: the private key is loaded at runtime without explicit validation or protection against accidental logging, broad exception handling could mask critical failures, and the server has elevated permissions (network_http, env_vars) appropriate to its purpose but should employ additional safeguards around sensitive operations. 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.
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. Secret — never commit or share. | (required) |
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
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-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption