file2markdown

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.

{
  "type": "object",
  "properties": {
    "url": {
      "title": "Url",
      "type": "string"
    },
    "filename_hint": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Filename Hint"
    },
    "quality_check": {
      "default": "basic",
      "title": "Quality Check",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "title": "convert_urlArguments"
}

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.

{
  "type": "object",
  "properties": {
    "content_base64": {
      "title": "Content Base64",
      "type": "string"
    },
    "filename": {
      "title": "Filename",
      "type": "string"
    },
    "quality_check": {
      "default": "basic",
      "title": "Quality Check",
      "type": "string"
    }
  },
  "required": [
    "content_base64",
    "filename"
  ],
  "title": "convert_base64Arguments"
}

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.

{
  "type": "object",
  "properties": {
    "items": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Items",
      "type": "array"
    },
    "quality_check": {
      "default": "basic",
      "title": "Quality Check",
      "type": "string"
    },
    "include_markdown": {
      "default": true,
      "title": "Include Markdown",
      "type": "boolean"
    }
  },
  "required": [
    "items"
  ],
  "title": "convert_batchArguments"
}

List supported input formats, per-tier limits, and which features need Pro. Single source of truth — do not claim capabilities beyond what this returns.

{
  "type": "object",
  "properties": {},
  "title": "list_supported_formatsArguments"
}

Check your tier and remaining conversions before burning a call.

{
  "type": "object",
  "properties": {},
  "title": "usage_statusArguments"
}