English Français العربية

flatmark

Official registry Productivity

Document to Markdown MCP server: PDF, Word, PowerPoint, Excel and HTML, with OCR for large files.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http flatmark 'https://api.flatmark.dev/mcp/' --header 'X-API-Key: <Optional API key; the anonymous tier works without it>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "flatmark": {
            "type": "http",
            "url": "https://api.flatmark.dev/mcp/",
            "headers": {
                "X-API-Key": "<Optional API key; the anonymous tier works without it>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. flatmark
  2. Quickstart
  3. Use it from
  4. Templates
  5. Links
  6. API
  7. About the files here

flatmark

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 (n8n, Zapier, Make, Dify, SDKs and templates): https://github.com/flatmark-dev/flatmark-integrations

Templates

Ready-made workflows: https://flatmark.dev/templates

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.

Frequently asked questions

What is flatmark?

Document to Markdown MCP server: PDF, Word, PowerPoint, Excel and HTML, with OCR for large files.

How do I install flatmark?

It runs as a remote server. In Claude Code: claude mcp add --transport http flatmark 'https://api.flatmark.dev/mcp/' --header 'X-API-Key: <Optional API key; the anonymous tier works without it>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does flatmark need an API key?

Yes. It expects X-API-Key, which you set in its configuration.

Is flatmark open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains flatmark?

It is published by flatmark-dev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.