Skip to content

flatmark

by flatmark.dev · remote · no sign-in to list tools · v1.0.0 · published by dev.flatmark

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

Changes · 2
CompareRegistry entry

3 tools: 2 change things and 1 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • Warnconvert_document

    The server marks "convert_document" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"openWorldHint":true}; The name "convert_document" says "convert": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

3 tools

Changes things 2Claude Code: ask
  • convert_documentConvert a document up to 8 MB to Markdown and return it directly.1 finding

    Why it is in this group

    • The name "convert_document" says "convert": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "convert_document" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"openWorldHint":true}; The name "convert_document" says "convert": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Convert a document up to 8 MB to Markdown and return it directly. Pass the file as base64 in `content_base64`, or as a download link in `file`, and its name in `filename`. The extension decides the type: .pdf, .docx, .pptx, .xlsx, .html, .htm or .txt. Returns `markdown` and `meta` (`filename`, `length` in characters). PDFs come back as plain text without headings and without OCR. For scans, tables and page numbers, use `submit_conversion_job`. Works without an API key at the anonymous rate limit. Credits: 1 per call.

    Annotations the server declares

    • title: Convert a document to Markdown in one call
    • readOnlyHint: true
    • openWorldHint: true
  • submit_conversion_jobQueue a document up to 25 MB and 200 pages for conversion with OCR and tables.No findings

    Why it is in this group

    • The name "submit_conversion_job" says "submit": a word for a change.
    Description, as the server wrote it
    Queue a document up to 25 MB and 200 pages for conversion with OCR and tables. Pass the file as base64 in `content_base64`, or as a download link in `file`, and its name in `filename` (.pdf, .docx, .pptx, .xlsx, .html, .htm or .txt). Returns `job_id`, `status` and `result_url`. Call `get_conversion_job` with the `job_id` until `status` is `succeeded` or `failed`. A conversion may take up to about 2 minutes. Optional `webhook_url`: a public http or https URL that receives a POST with the job's final state. The request carries `X-Appkit-Signature: sha256=<hex>`, an HMAC-SHA256 of the raw body keyed with the returned `webhook_secret` (shown only once). 3 delivery attempts. Requires an API key. The credits are refunded if the job fails. The uploaded file is deleted when the job finishes. Results are kept for 7 days after submission. Credits: 10 per call.

    Annotations the server declares

    • title: Queue a document for conversion with OCR and tables
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
Only reads 1Claude Code: allow
  • get_conversion_jobCheck a queued conversion job you submitted.No findings

    Why it is in this group

    • The name "get_conversion_job" says "get": a word for reading.
    Description, as the server wrote it
    Check a queued conversion job you submitted. Returns `job_id` and `status` (`queued`, `running`, `succeeded` or `failed`). A succeeded job includes the `markdown` when it is under 100 KB, otherwise a `result_url` to download it (also free). A failed job includes `error`, one sentence with the reason. Results are deleted 7 days after submission. An expired result is reported in `error`. Requires an API key. Credits: free. This tool is not metered.

    Annotations the server declares

    • title: Check a queued conversion
    • readOnlyHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.0. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__markdown-converter__get_conversion_job"
    ],
    "ask": [
      "mcp__markdown-converter__convert_document",
      "mcp__markdown-converter__submit_conversion_job"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as markdown-converter. Review it before you use it.