Unfold MCP Server
This server converts PDF, Word, PowerPoint, and Excel documents to Markdown via the Unfold API.
Call
convert_documentwith either a publicurlor a localpathto upload a file up to 10 MB.Automatically detects the document format from content.
Truncates Markdown output using
max_chars(default 20,000; minimum 100; maximum 500,000).Returns the API's JSON response, including
quota_remainingwhen reported, plus plain-language errors for refused keys, quota limits, or unprocessable input.Requires a RapidAPI or api.market key; each call uses one request on your plan (free Basic plan: 15 requests/month).
Authenticates and bills requests through RapidAPI: the server uses your RapidAPI key to call the Unfold API on the RapidAPI marketplace, so each document-to-Markdown conversion counts against your RapidAPI plan's quota, with quota_remaining and plain-word errors (key refused, quota reached) surfaced to the agent.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Unfold MCP Server convert https://example.com/report.pdf to markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
hybridforgelab-unfold-mcp: moved to bytestay-unfold-mcp
This package has moved to bytestay-unfold-mcp. Hybrid Forge Lab is now ByteStay.
This last version only installs bytestay-unfold-mcp and forwards to it. It prints a one-line notice on stderr and gets no more updates.
Switch
Replace hybridforgelab-unfold-mcp with bytestay-unfold-mcp in your MCP client config:
"command": "uvx",
"args": ["--from", "bytestay-unfold-mcp", "unfold-mcp"]Or with Claude Code:
claude mcp add unfold --env RAPIDAPI_KEY=your-rapidapi-key -- uvx --from bytestay-unfold-mcp unfold-mcpThe environment variables are the same, so your keys keep working.
Related MCP server: shuck-file
Links
Package: bytestay-unfold-mcp
Source: Bytestay/unfold-mcp
Unfold API: unfold.bytestay.pt
Available Tools
1 toolconvert_documentARead-onlyIdempotent
Convert one document to Markdown. Give either url or path. The format is detected from the content.
Inputs: url, path, max_chars.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of misselection or overlapping purpose. The single tool's purpose (document to Markdown conversion) is unambiguous.
The lone name, convert_document, follows a clean verb_noun snake_case pattern. With a single tool there is no convention mixing to worry about.
One tool is exactly on-scope for a narrow conversion server, but the surface feels thin—there's no batch option or format-discovery endpoint to round it out. Acceptable for its stated purpose but minimal.
The core lifecycle (take a URL or path, emit Markdown with auto-detected format) is fully covered, so an agent won't hit a dead end for the primary workflow. Minor gaps exist: no batch conversion and no way to list supported formats or output options.
Maintenance
Related MCP Connectors
Convert PDFs, Office files, spreadsheets and images to clean Markdown, sized for agent context.
Document conversion and OCR for AI agents: PDF, Office docs, images to text.
Convert PDF, DOCX, PPTX, XLSX and HTML links to clean Markdown with tables and RAG chunks.
Any URL to clean markdown/JSON; PDF, XLSX, CSV, DOCX to text and tables. Free tier for agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceConverts files (PDF, DOCX, PPTX, XLSX, images via OCR) and URLs to Markdown, enabling AI clients to read them via a single MCP tool.1GPL 3.0
- AlicenseNot gradedqualityDmaintenanceProvides AI agents with document conversion to Markdown, intelligently routing small and large files, and enabling targeted extraction via sections, search, and token budgets.39 PyPI6MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to inspect and convert PDF, PowerPoint, Excel, and many other file formats into clean, structured Markdown, with chunking support for long documents.Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI agents and MCP-capable platforms to convert documents such as docx, pptx, xlsx, pdf, odt, rtf, epub, and csv into clean GitHub-Flavored Markdown through a single tool call. Runs fully locally with no API key, no network access, and no OCR, returning structured errors for scanned, encrypted, or unsupported files.1MIT