# Apify Document & Media Tools MCP server

> Enables AI agents to convert documents to Markdown, perform OCR, transcribe audio, generate speech, take website screenshots, and extract video frames.

- Repository: https://github.com/AndriyVK/-apify-document-tools
- Page: https://hostedmcp.org/servers/andriyvk/apify-document-tools
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 0.4.0

## Install

### Claude Code

```sh
claude mcp add --transport http apify-document-tools 'https://mcp.apify.com/?tools=ai_admin/document-to-markdown,ai_admin/office-to-pdf,ai_admin/pdf-image-converter,ai_admin/audio-transcriber,ai_admin/image-to-text-ocr,ai_admin/text-to-speech,ai_admin/website-screenshot,ai_admin/domain-whois-dns-ssl,ai_admin/video-frame-extractor,ai_admin/social-video-transcript'
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "apify-document-tools": {
      "url": "https://mcp.apify.com/?tools=ai_admin/document-to-markdown,ai_admin/office-to-pdf,ai_admin/pdf-image-converter,ai_admin/audio-transcriber,ai_admin/image-to-text-ocr,ai_admin/text-to-speech,ai_admin/website-screenshot,ai_admin/domain-whois-dns-ssl,ai_admin/video-frame-extractor,ai_admin/social-video-transcript"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "apify-document-tools": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=ai_admin/document-to-markdown,ai_admin/office-to-pdf,ai_admin/pdf-image-converter,ai_admin/audio-transcriber,ai_admin/image-to-text-ocr,ai_admin/text-to-speech,ai_admin/website-screenshot,ai_admin/domain-whois-dns-ssl,ai_admin/video-frame-extractor,ai_admin/social-video-transcript"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"apify-document-tools","type":"http","url":"https://mcp.apify.com/?tools=ai_admin/document-to-markdown,ai_admin/office-to-pdf,ai_admin/pdf-image-converter,ai_admin/audio-transcriber,ai_admin/image-to-text-ocr,ai_admin/text-to-speech,ai_admin/website-screenshot,ai_admin/domain-whois-dns-ssl,ai_admin/video-frame-extractor,ai_admin/social-video-transcript"}'
```

### Codex

```sh
codex mcp add apify-document-tools --url 'https://mcp.apify.com/?tools=ai_admin/document-to-markdown,ai_admin/office-to-pdf,ai_admin/pdf-image-converter,ai_admin/audio-transcriber,ai_admin/image-to-text-ocr,ai_admin/text-to-speech,ai_admin/website-screenshot,ai_admin/domain-whois-dns-ssl,ai_admin/video-frame-extractor,ai_admin/social-video-transcript'
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.apify-document-tools]
url = "https://mcp.apify.com/?tools=ai_admin/document-to-markdown,ai_admin/office-to-pdf,ai_admin/pdf-image-converter,ai_admin/audio-transcriber,ai_admin/image-to-text-ocr,ai_admin/text-to-speech,ai_admin/website-screenshot,ai_admin/domain-whois-dns-ssl,ai_admin/video-frame-extractor,ai_admin/social-video-transcript"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http apify-document-tools 'https://mcp.apify.com/?tools=ai_admin/document-to-markdown,ai_admin/office-to-pdf,ai_admin/pdf-image-converter,ai_admin/audio-transcriber,ai_admin/image-to-text-ocr,ai_admin/text-to-speech,ai_admin/website-screenshot,ai_admin/domain-whois-dns-ssl,ai_admin/video-frame-extractor,ai_admin/social-video-transcript'
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "apify-document-tools": {
      "url": "https://mcp.apify.com/?tools=ai_admin/document-to-markdown,ai_admin/office-to-pdf,ai_admin/pdf-image-converter,ai_admin/audio-transcriber,ai_admin/image-to-text-ocr,ai_admin/text-to-speech,ai_admin/website-screenshot,ai_admin/domain-whois-dns-ssl,ai_admin/video-frame-extractor,ai_admin/social-video-transcript",
      "type": "http"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `APIFY_TOKEN` | no | no |  |

## Tools (14)

- `get-actor-run`: Get detailed information about a specific Actor run. Returns run result: status, storages (datasets/keyValueStores alias map), stats, summary, nextStep. - summary describes the past (e.g. "SUCCEEDED in 22s. 47 items; 3 fields available."). - nextStep prescribes one primary follow-up action with identifiers interpolated (e.g. "Use get-dataset-items with datasetId=..."). - waitSecs (0–45, default 30) waits up to that many seconds for terminal status before returning. USAGE: - Use to check the status of a run started by any Actor-running tool. - Pass waitSecs > 0 to block until terminal (or until the cap elapses). USAGE EXAMPLES: - user_input: Show details of run y2h7sK3Wc - user_input: Wait for run y2h7sK3Wc to finish (read-only)
- `get-dataset-items`: Get items (rows) from a dataset — the output/results produced by an Actor run. Returns the rows themselves, not dataset metadata, counts, or a schema. When the user provides a datasetId and asks to retrieve results, output, data, or rows, call this tool directly. Default limit is 20. Use clean=true to skip empty items and hidden fields. USAGE: - Use when you need to read data from a dataset (all items or only selected fields). USAGE EXAMPLES: - user_input: Retrieve results from dataset abc123 - user_input: Get only metadata.url and title from dataset username~my-dataset (read-only)
- `get-key-value-store-record`: Get the value stored under a specific key in a key-value store — a single record, not a listing of all keys. Requires the exact key name. The response preserves the original Content-Encoding; most clients handle decompression automatically. A record over 262144 bytes is returned as a link to download it, not as its value. USAGE: - Use when you need to retrieve a specific record (JSON, text, or binary) from a store. USAGE EXAMPLES: - user_input: Get record INPUT from store abc123 - user_input: Get record data.json from store username~my-store (read-only)
- `abort-actor-run`: Abort an Actor run that is currently starting or running. For runs with status SUCCEEDED, FAILED, ABORTING, ABORTED, or TIMED-OUT, this call has no effect. The results will include the updated run details after the abort request. USAGE: - Use when you need to stop a run that is taking too long or misconfigured. USAGE EXAMPLES: - user_input: Abort run y2h7sK3Wc - user_input: Gracefully abort run y2h7sK3Wc
- `ai_admin--document-to-markdown`: This tool calls the Actor "ai_admin/document-to-markdown" and retrieves its output results. Actor description: From $1 per 1,000 pages: PDF, scanned PDF and images (OCR incl. Ukrainian and Russian), DOCX, DOC, XLSX, XLS, PPTX, PPT, ODT, RTF and HTML to clean Markdown with headings and tables, plus JSON tables and RAG chunks. OCR charged only for scanned pages.
- `ai_admin--office-to-pdf`: This tool calls the Actor "ai_admin/office-to-pdf" and retrieves its output results. Actor description: Convert Word, Excel, PowerPoint (incl. legacy DOC, XLS, PPT), OpenDocument, RTF, CSV, HTML and images to PDF or archival PDF/A-2b for courts, tax portals and archives. $10 per 1,000 documents, batch and merge, files stay inside the Actor.
- `ai_admin--pdf-image-converter`: This tool calls the Actor "ai_admin/pdf-image-converter" and retrieves its output results. Actor description: $2 per 1,000 pages: PDF pages to PNG, JPG, WebP or TIFF (DPI, page ranges), images to PDF, and iPhone HEIC to JPG - both directions in one Actor. Resize, merge images into one PDF, download links and a ZIP of all files.
- `ai_admin--audio-transcriber`: This tool calls the Actor "ai_admin/audio-transcriber" and retrieves its output results. Actor description: Whisper large-v3 for $5 per 1,000 minutes (30¢ an hour): transcribe MP3, WAV, M4A, MP4, MOV, WebM and more to text, timestamped segments and SRT/VTT subtitles. 99 languages incl. Ukrainian, no API key, hours-long files split automatically.
- `ai_admin--image-to-text-ocr`: This tool calls the Actor "ai_admin/image-to-text-ocr" and retrieves its output results. Actor description: Extract text from images (PNG, JPG, WebP, TIFF, HEIC) and scanned PDF pages in bulk. Returns plain text plus lines and words with confidence and bounding boxes. 38 languages incl. Ukrainian, Chinese, Arabic. Auto-rotate.
- `ai_admin--text-to-speech`: This tool calls the Actor "ai_admin/text-to-speech" and retrieves its output results. Actor description: Natural neural voices licensed for commercial use: text, PDF and Word files to MP3/WAV/OGG with SRT/VTT subtitles. 37 voices in 23 languages incl. 3 Ukrainian voices (rare on the market), English, German, Spanish. No API key, no per-character fees.
- `ai_admin--website-screenshot`: This tool calls the Actor "ai_admin/website-screenshot" and retrieves its output results. Actor description: Capture full-page or viewport screenshots of websites (PNG, JPEG, WebP) and save web pages or raw HTML as PDF. Desktop, laptop, tablet and phone devices, dark mode, element screenshots, cookie banners hidden, lazy images loaded.
- `ai_admin--domain-whois-dns-ssl`: This tool calls the Actor "ai_admin/domain-whois-dns-ssl" and retrieves its output results. Actor description: Check many domains at once: registration (RDAP/WHOIS) with registrar, creation and expiry dates, availability; DNS records A, AAAA, MX, NS, TXT, SPF, DMARC, CAA; SSL certificate issuer, validity and days left. For monitoring, SEO and lead research.
- `ai_admin--video-frame-extractor`: This tool calls the Actor "ai_admin/video-frame-extractor" and retrieves its output results. Actor description: Extract still frames from video files (MP4, MOV, WebM, MKV, AVI): N evenly spaced, every N seconds, exact timestamps, scene changes or keyframes. JPG/PNG/WebP with timecodes, video metadata and a free contact sheet. Ready for AI vision.
- `ai_admin--social-video-transcript`: This tool calls the Actor "ai_admin/social-video-transcript" and retrieves its output results. Actor description: Transcripts and SRT/VTT subtitles of YouTube, TikTok, Instagram Reels, Facebook and X videos, translated into Ukrainian and 20 other languages in the same run. Captions first, Whisper large-v3 when there are none. Failed videos are free. No API key.

## FAQ

### Can I set a spending limit for each tool call?

Yes, every tool accepts a max_charge_usd safety limit per call, which defaults to $1.

### How do I authenticate with the local installation?

You need to provide your Apify API token in the environment variables.
