Skip to content
MCP server

flatmark

Convert PDF, Word, PowerPoint, Excel and HTML to Markdown, with an OCR queue

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About flatmark

flatmark is a freemium MCP server for files and documents. It runs as a hosted remote server, so there is nothing to install locally.

flatmark does not use a language model: conversion extracts text and structure and passes the output of two open-source engines through unchanged. Files up to 8 MB convert in one call with Microsoft's MarkItDown, keeping headings, lists and tables. Files up to 25 MB and 200 pages go through a queue that runs IBM's Docling, which applies OCR to scans and detects reading order and tables, returning Markdown plus a JSON structure file with page numbers for PDFs.

The MCP server shares its API key and credit balance with the REST API, and an anonymous tier works without a key at lower limits. The queue delivers results by polling or a signed webhook. Direct calls keep no file content; queued uploads are deleted after conversion and results after 7 days. Servers are at Hetzner in Nuremberg, Germany.

Credits drive pricing: a free plan gives 100 a month and 10 a day without an account. Files over a limit return an error and cost nothing.

Install

Run in a terminal

claude mcp add --transport http markdown-converter https://api.flatmark.dev/mcp/

Add to Settings → Connectors → Add custom connector

https://api.flatmark.dev/mcp/
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "markdown-converter": {
      "url": "https://api.flatmark.dev/mcp/"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "markdown-converter": {
      "type": "http",
      "url": "https://api.flatmark.dev/mcp/"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "markdown-converter": {
      "serverUrl": "https://api.flatmark.dev/mcp/"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "markdown-converter": {
      "type": "http",
      "url": "https://api.flatmark.dev/mcp/"
    }
  }
}

What it does

One-call conversion
Files up to 8 MB convert in a single request with MarkItDown.
OCR queue
Large and scanned files, up to 25 MB and 200 pages, run through Docling.
Structure output
Queued jobs also return a JSON file of document structure.
Signed webhooks
Poll jobs or receive a signed webhook on completion.
Anonymous tier
Try it without an account or API key at lower limits.
EU hosting
Servers are in Nuremberg, Germany.

Good for

  • Prepare documents for a RAG pipeline
  • Let an agent read a PDF as Markdown
  • OCR a scanned report
  • Convert Excel sheets and slide decks into text for an LLM

Pricing

Freemium

Free: 100 credits a month; Essential 20 euros a month for 10,000 credits; Scale 80 euros a month for 100,000

Prices change. Check flatmark.dev before you buy.

flatmark FAQ

Which formats are supported?

PDF, .docx, .pptx, .xlsx, HTML and plain text; older .doc, .ppt and .xls are rejected.

Are my files stored?

Direct calls keep no content; queued uploads are deleted after conversion and results after 7 days.

What do the plans cost?

Free is 100 credits a month; Essential is 20 euros for 10,000; Scale is 80 euros for 100,000.

Is a language model involved?

No. It extracts text and structure and does not rewrite or summarize.

Is flatmark free?

flatmark has a free plan, with paid plans for more usage or features.

How do I add flatmark to Claude Code?

Run this command in your terminal: claude mcp add --transport http markdown-converter https://api.flatmark.dev/mcp/

What are the best alternatives to flatmark?

The closest alternatives to flatmark are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to flatmark

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools