# flatmark

> flatmark is a freemium MCP server for files and documents. Convert PDF, Word, PowerPoint, Excel and HTML to Markdown, with an OCR queue. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://flatmark.dev
- **Repository:** https://github.com/flatmark-dev/flatmark
- **MCP Registry name:** dev.flatmark/markdown-converter
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.flatmark.dev/mcp/
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "markdown-converter": {
      "url": "https://api.flatmark.dev/mcp/"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/flatmark
