flatmark
REMOTE · API.FLATMARK.DEV · SCANNED OCT 4
Document to Markdown MCP server: PDF, Word, PowerPoint, Excel and HTML, with OCR for large files.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security80
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability68
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 772 tokens (~257/item across 3 items; 3 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management10
- Stability observed for 3 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 3 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 3 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the flatmark MCP server?
flatmark is a hosted endpoint at https://api.flatmark.dev/mcp/, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · api.flatmark.dev
claude mcp add --transport http dev-flatmark-markdown-converter 'https://api.flatmark.dev/mcp/'
{
"mcpServers": {
"dev-flatmark-markdown-converter": {
"url": "https://api.flatmark.dev/mcp/"
}
}
} {
"servers": {
"dev-flatmark-markdown-converter": {
"type": "http",
"url": "https://api.flatmark.dev/mcp/"
}
}
} [mcp_servers.dev-flatmark-markdown-converter] url = "https://api.flatmark.dev/mcp/"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"dev-flatmark-markdown-converter": {
"type": "remote",
"url": "https://api.flatmark.dev/mcp/",
"enabled": true
}
}
} openclaw mcp add dev-flatmark-markdown-converter --url 'https://api.flatmark.dev/mcp/' --transport streamable-http
mcp_servers:
dev-flatmark-markdown-converter:
url: "https://api.flatmark.dev/mcp/" {
"McpServers": {
"dev-flatmark-markdown-converter": {
"Transport": "http",
"Url": "https://api.flatmark.dev/mcp/"
}
}
} assistant mcp add dev-flatmark-markdown-converter -t streamable-http -u 'https://api.flatmark.dev/mcp/'
{
"mcpServers": {
"dev-flatmark-markdown-converter": {
"type": "http",
"url": "https://api.flatmark.dev/mcp/"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 4 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
- 2 Oct 26 +1
- Stability: unverified → 0.03 ▲ functional
- 1 Oct 26 72
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 6 Oct 2026 · Probed https://api.flatmark.dev/mcp/
TLS valid
Negotiated TLS 1.3 with TLS_AES_256_GCM_SHA384 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=api.flatmark.dev | CN=YE2,O=Let's Encrypt,C=US | 15 Sept 2026 | 14 Dec 2026 | ECDSA 256 | ECDSA-SHA384 | 671e052e7116d912f6da6e7aff6fec0a5fc |
| SANs: api.flatmark.dev | ||||||
| CN=YE2,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 4df3b15dd6c0784c507cd37b58e6f115 |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
| CN=ISRG Root X1,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 4 Jun 2015 | 4 Jun 2035 | RSA 4096 | SHA256-RSA | 8210cfb0d240e3594463e0bb63828b00 |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of api.flatmark.dev. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| dev. | present | 60074 | 8 | Verified |
| flatmark.dev. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=31536000; includeSubDomains |
| content-security-policy | default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; connect-src 'self' https://api.flatmark.dev; worker-src 'self' blob:; font-src 'self' data:; frame-ancestors 'none'; form-action 'self' https://polar.sh https://*.polar.sh https://sandbox.polar.sh; base-uri 'self' |
| x-content-type-options | nosniff |
| x-frame-options | DENY |
| referrer-policy | strict-origin-when-cross-origin |
| permissions-policy | geolocation=(), microphone=(), camera=(), payment=() |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.flatmark.dev/mcp/ | Verified | 200 | |
| http (plaintext) | http://api.flatmark.dev/mcp/ | HTTPS enforced | 301 | https://api.flatmark.dev/mcp/ |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
convert_document Convert a document to Markdown in one call ~257
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.
| Name | Type | Req | Description |
|---|---|---|---|
| content_base64 | – | – | The file content, base64-encoded. Up to 8 MB before encoding. |
| file | object | – | The file as a download link, instead of `content_base64`. In ChatGPT, pass the user's uploaded file here. Other clients can set `download_url` to a public https URL. |
| filename | string | yes | The file name with its extension (.pdf, .docx, .pptx, .xlsx, .html, .htm or .txt). The extension decides how the file is read. |
Structured output declared, but exposes no named fields.
No examples provided.
get_conversion_job Check a queued conversion ~137
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.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | The `job_id` returned by `submit_conversion_job`. |
Structured output declared, but exposes no named fields.
No examples provided.
submit_conversion_job Queue a document for conversion with OCR and tables ~378
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.
| Name | Type | Req | Description |
|---|---|---|---|
| content_base64 | – | – | The file content, base64-encoded. Up to 25 MB before encoding. |
| file | object | – | The file as a download link, instead of `content_base64`. In ChatGPT, pass the user's uploaded file here. Other clients can set `download_url` to a public https URL. |
| filename | string | yes | The file name with its extension (.pdf, .docx, .pptx, .xlsx, .html, .htm or .txt). The extension decides how the file is read. |
| webhook_url | – | – | Optional. A public http or https URL that receives the job's final state. |
Structured output declared, but exposes no named fields.
No examples provided.
What is the flatmark MCP server?
flatmark is an MCP server listed in the public MCP registry as dev.flatmark/markdown-converter. Document to Markdown MCP server: PDF, Word, PowerPoint, Excel and HTML, with OCR for large files. This page covers its hosted endpoint (https://api.flatmark.dev/mcp/).
Is the flatmark MCP server safe to use?
flatmark scores 74 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the flatmark MCP server expose?
flatmark exposes 3 tools: convert_document, submit_conversion_job, get_conversion_job. Their descriptions and schemas cost roughly 772 tokens of context every time the server is loaded.
Does the flatmark MCP server require authentication?
No. We connected to flatmark without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the flatmark MCP server still maintained?
flatmark is still listed as active in the MCP registry. We last reached this channel on 4 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.