Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "file2markdown": {
      "type": "http",
      "url": "https://mcp.file2markdown.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${FILE2MARKDOWN_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp --header "Authorization: Bearer ${FILE2MARKDOWN_TOKEN}"

[mcp_servers.file2markdown]
url = "https://mcp.file2markdown.ai/mcp"
bearer_token_env_var = "FILE2MARKDOWN_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "file2markdown": {
      "type": "remote",
      "url": "https://mcp.file2markdown.ai/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:FILE2MARKDOWN_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "file2markdown": {
      "type": "http",
      "url": "https://mcp.file2markdown.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${FILE2MARKDOWN_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=file2markdown&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmZpbGUybWFya2Rvd24uYWkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7RklMRTJNQVJLRE9XTl9UT0tFTn0ifX0%3D"
}

{
  "servers": {
    "file2markdown": {
      "type": "http",
      "url": "https://mcp.file2markdown.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${FILE2MARKDOWN_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "file2markdown": {
      "httpUrl": "https://mcp.file2markdown.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${FILE2MARKDOWN_TOKEN}"
      }
    }
  }
}

extensions:
  "file2markdown":
    enabled: true
    name: "file2markdown"
    type: streamable_http
    uri: "https://mcp.file2markdown.ai/mcp"
    headers:
      "Authorization": "Bearer ${FILE2MARKDOWN_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${FILE2MARKDOWN_TOKEN}. The registry never accepts secret values.

Quality 83 / 100good

protocol88 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
warn
protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene71 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
fail
tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: usage_status (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); convert_url (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); convert_base64 (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
pass
tools.token_costabout 840 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changes1 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

5 tools, about 840 tokens to load them all · tool set 1a280bca261a · tools last changed 2026-10-13 · checked 2026-10-20 10:35 UTC

Tool changes

2026-10-13convert_batchadded
Convert 2-10 documents to Markdown in one call (Pro API key required). Each item is either {"url": ..., "filename_hint"?: ...} or {"content_base64": ..., "filename": ...}; types may be mixed. Items are converted in parallel and isolated: one bad URL or file never fails the batch — its slot returns ok:false with the error. The combined markdown shares one output budget, split evenly across items (per-item `truncated` flags apply). Set include_markdown=false to get only metadata + quality per item (health-check a folder without flooding your context). Anonymous callers: use convert_url / convert_base64 individually.

Full 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.

Trust 96 / 100

provenance85

liveness100

freshness100

hygiene100

+repository +dns-namespace +website +reachable +uptime-100% +updated-8d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://mcp.file2markdown.ai/mcp` streamable-http	none	yes	100%	332 ms	2026-07-28	2026-10-20

Tools (5)

`convert_base64`	Convert base64-encoded file contents to Markdown. filename is required and drives format detection (e.g. "report.docx"). Intended for programmatic MCP clients; for anything with a URL, prefer convert_url. quality_check: "basic" (default) attaches local output-health checks in the `quality` field; "ai" additionally sends selected excerpts of the converted text to TypeSafe for narrow yes/no judgments. See convert_url.
`convert_batch`	Convert 2-10 documents to Markdown in one call (Pro API key required). Each item is either {"url": ..., "filename_hint"?: ...} or {"content_base64": ..., "filename": ...}; types may be mixed. Items are converted in parallel and isolated: one bad URL or file never fails the batch — its slot returns ok:false with the error. The combined markdown shares one output budget, split evenly across items (per-item `truncated` flags apply). Set include_markdown=false to get only metadata + quality per item (health-check a folder without flooding your context). Anonymous callers: use convert_url / convert_base64 individually.
`convert_url`	Fetch a URL (web page, PDF, Office doc, and more) and convert it to Markdown. Works on publicly accessible URLs. Web pages are converted from their served HTML; JavaScript-rendered content may be incomplete. Optional filename_hint (e.g. "report.pdf") helps format detection when the URL has no file extension. The result carries a `quality` object (output-health check of the returned Markdown: status review / no_issues_detected / not_evaluated, coverage and a list of issues with line locations). quality_check="basic" (default) runs only local deterministic checks. quality_check="ai" additionally sends selected excerpts of the CONVERTED text to TypeSafe for narrow yes/no judgments (garbled text, hard-wrapped prose, broken tables); it is off unless requested. No check compares against the source document.
`list_supported_formats`	List supported input formats, per-tier limits, and which features need Pro. Single source of truth — do not claim capabilities beyond what this returns.
`usage_status`	Check your tier and remaining conversions before burning a call.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "ai.file2markdown/file2markdown",
  "icons": [
    {
      "src": "https://www.file2markdown.ai/logo-800.png",
      "mimeType": "image/png"
    }
  ],
  "title": "file2markdown",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.file2markdown.ai/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Optional Pro API key as 'Bearer f2m_...' — removes the daily limit and enables OCR. Free tier works without it."
        }
      ]
    }
  ],
  "version": "1.1.0",
  "repository": {
    "url": "https://github.com/Robinhill85/file2markdown-mcp",
    "source": "github"
  },
  "websiteUrl": "https://www.file2markdown.ai/mcp",
  "description": "Convert docs and web pages to clean Markdown: PDF, DOCX, XLSX, EPUB, scans, URLs. Batch of 10."
}