Search / dev.flatmark/markdown-converter
protogridR0· no sign-inDocument to Markdown MCP server: PDF, Word, PowerPoint, Excel and HTML, with OCR for large files.
v1.0.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"markdown-converter": {
"type": "http",
"url": "https://api.flatmark.dev/mcp/",
"headers": {
"X-API-Key": "${X_API_KEY}"
}
}
}
}claude mcp add --transport http markdown-converter https://api.flatmark.dev/mcp/ --header "X-API-Key: ${X_API_KEY}"[mcp_servers.markdown-converter]
url = "https://api.flatmark.dev/mcp/"
env_http_headers = { "X-API-Key" = "X_API_KEY" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"markdown-converter": {
"type": "remote",
"url": "https://api.flatmark.dev/mcp/",
"enabled": true,
"headers": {
"X-API-Key": "{env:X_API_KEY}"
}
}
}
}{
"mcpServers": {
"markdown-converter": {
"type": "http",
"url": "https://api.flatmark.dev/mcp/",
"headers": {
"X-API-Key": "${X_API_KEY}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=markdown-converter&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLmZsYXRtYXJrLmRldi9tY3AvIiwiaGVhZGVycyI6eyJYLUFQSS1LZXkiOiIke1hfQVBJX0tFWX0ifX0%3D"
}{
"servers": {
"markdown-converter": {
"type": "http",
"url": "https://api.flatmark.dev/mcp/",
"headers": {
"X-API-Key": "${X_API_KEY}"
}
}
}
}{
"mcpServers": {
"markdown-converter": {
"httpUrl": "https://api.flatmark.dev/mcp/",
"headers": {
"X-API-Key": "${X_API_KEY}"
}
}
}
}extensions:
"markdown-converter":
enabled: true
name: "markdown-converter"
type: streamable_http
uri: "https://api.flatmark.dev/mcp/"
headers:
"X-API-Key": "${X_API_KEY}"
timeout: 300
Placeholders to fill from your own secret store: ${X_API_KEY}. The registry never accepts secret values.
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations3 of 3 tools declare readOnlyHint or destructiveHinttools.directory_hints1 of 3 tools declare all four hints; missing: convert_document (destructiveHint, idempotentHint); get_conversion_job (destructiveHint, idempotentHint)tools.token_costabout 1,129 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes3 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageget_conversion_jobchangedannotationssubmit_conversion_jobchangedannotationsconvert_documentchangedannotationsFull history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +dns-namespace +website +reachable +uptime-99% +updated-18d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://api.flatmark.dev/mcp/ streamable-http | none | yes | 99% | 485 ms | 2025-11-25 | 2026-10-19 |
convert_documentread-only | 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. |
get_conversion_jobread-only | 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. |
submit_conversion_job | 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. |
Schemas: list_tools.
{
"name": "dev.flatmark/markdown-converter",
"title": "flatmark",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://api.flatmark.dev/mcp/",
"type": "streamable-http",
"headers": [
{
"name": "X-API-Key",
"isSecret": true,
"description": "Optional API key; the anonymous tier works without it"
}
]
}
],
"version": "1.0.0",
"repository": {
"url": "https://github.com/flatmark-dev/flatmark",
"source": "github"
},
"websiteUrl": "https://flatmark.dev",
"description": "Document to Markdown MCP server: PDF, Word, PowerPoint, Excel and HTML, with OCR for large files."
}