flatmark MCP server
Commit Nov 7, 2026Converts PDF, Word, PowerPoint, Excel, and HTML documents into Markdown using OCR and table detection.
Also known as flatmark-dev/flatmark
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 7, 2026
- License
- MIT
What is flatmark MCP?
flatmark converts PDF, Word, PowerPoint, Excel, and HTML documents into Markdown using OCR and table detection.
Summary generated from the project's README
About flatmark MCP server
Flatmark provides a way to transform various document formats including PDF, Word, PowerPoint, Excel, and HTML into Markdown. It serves developers and AI users who need to process structured data from files. The service operates via a REST API or as an MCP server that connects to clients like Claude Desktop, Cursor, Windsurf, Cline, and Claude Code. Users can connect using a streamable-HTTP endpoint.
Small files under 8 MB use MarkItDown for immediate conversion in a single call. For larger files up to 25 MB or documents reaching 200 pages, the system utilizes a queue running Docling. This queue handles OCR and table detection, returning both Markdown and a JSON structure through polling or signed webhooks. The infrastructure is hosted in Germany. While an anonymous tier exists without a key, providing a FLATMARK_API_KEY increases rate limits. The free plan includes 100 credits monthly without requiring a credit card.
What you can do with it
- 1Convert small documents quicklyTransform a PDF file under 8 MB into Markdown using a single API request.
- 2Process large scanned filesSubmit a large document to a queue to perform OCR and table detection.
Written from the project's README. Every use case is checked against a quote from it.
How to install flatmark MCP
Formats verified 10 Nov 2026Install flatmark MCP in Claude Code
$ claude mcp add --transport http flatmark https://api.flatmark.dev/mcp/Install flatmark MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"flatmark": {
"url": "https://api.flatmark.dev/mcp/"
}
}
}Install flatmark MCP in VS Code
.vscode/mcp.json
{
"servers": {
"flatmark": {
"type": "http",
"url": "https://api.flatmark.dev/mcp/"
}
}
}Install flatmark MCP in Codex
~/.codex/config.toml
[mcp_servers.flatmark] url = "https://api.flatmark.dev/mcp/"
Install flatmark MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"flatmark": {
"httpUrl": "https://api.flatmark.dev/mcp/"
}
}
}README
View on GitHubflatmark
Document to Markdown API and MCP server for PDF, Word, PowerPoint, Excel and HTML. OCR queue for large files. Hosted in Germany.
flatmark converts PDF, Word, PowerPoint, Excel and HTML to Markdown over a REST API and an MCP server. Files up to 8 MB convert in one call with MarkItDown. Files up to 25 MB and 200 pages go through a queue that runs Docling with OCR and table detection. The queue returns Markdown and a JSON structure file, by polling or a signed webhook. The servers are in Germany. The free plan has 100 credits a month and needs no card.
Quickstart
Convert a PDF to Markdown in one call. The anonymous tier needs no key; add
-H "X-API-Key: $FLATMARK_API_KEY" for your plan's limits.
curl -sO https://flatmark.dev/app-static/samples/sample.pdf
curl -F file=@sample.pdf https://api.flatmark.dev/v1/convert
{"markdown":"Hello Docling smoke test\n\n","meta":{"filename":"sample.pdf"}}
Files over 8 MB and scanned documents go through the OCR queue instead:
POST /v1/convert/jobs, then poll or receive a signed webhook.
Use it from
MCP server
Streamable-HTTP endpoint: https://api.flatmark.dev/mcp/ — the anonymous
tier works without a key; an API key raises the limits.
Claude Code:
claude mcp add --transport http flatmark https://api.flatmark.dev/mcp/
Claude Code: /plugin marketplace add flatmark-dev/flatmark then /plugin install flatmark@flatmark (set FLATMARK_API_KEY for your key).
Cursor / Windsurf / Cline / Claude Desktop:
{
"mcpServers": {
"flatmark": {
"url": "https://api.flatmark.dev/mcp/"
}
}
}
One-click installs for every client: https://flatmark.dev/connect
Integrations (Dify, Python SDK and templates): https://github.com/flatmark-dev/flatmark-integrations
Templates
Ready-made workflows: https://flatmark.dev/templates
Links
- Website: https://flatmark.dev/go/github
- API docs: https://api.flatmark.dev/docs · OpenAPI
- Pricing: https://flatmark.dev/pricing
- Convert a PDF free: https://flatmark.dev/tools/pdf-to-markdown
- llms.txt: https://flatmark.dev/llms.txt
- Privacy policy: https://flatmark.dev/privacy
- Support: https://flatmark.dev/support
API
Base URL https://api.flatmark.dev/ — authenticate with an X-API-Key header;
anonymous calls work at a lower rate limit.
About the files here
.claude-plugin/— Claude Code plugin, with this repo as its own marketplace..mcp.json— the MCP server the Claude Code plugin connects to.gemini-extension.json— Gemini CLI extension manifest.glama.json— Glama server claim (names the maintainer).mcp.json— Agent Plugins 1.0 MCP server config.plugin.json— Agent Plugins 1.0 plugin manifest.server.json— the entry in the official MCP Registry.skills/— an Agent Skill (agentskills.io SKILL.md) for skill galleries.
flatmark MCP questions
How do I add flatmark MCP to Claude Code?
Run claude mcp add --transport http flatmark https://api.flatmark.dev/mcp/ in your terminal. Add --scope user to make it available in every project.
How do I add flatmark MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What file formats can be converted?
The server supports converting PDF, Word, PowerPoint, Excel, and HTML files.
How are large files handled?
Files up to 8 MB are converted in one call, while files up to 25 MB and 200 pages are processed through an OCR queue with table detection.
Is there a free tier available?
Yes, the free plan provides 100 credits per month and does not require a credit card.