# SmartPDF [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/kirmoz1997/smartpdf-agents  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/smartpdf

## Description
24 PDF tools: convert to and from Office and JPG, compress, merge, split, OCR, sign, watermark

## Tools
Capabilities this server exposes over MCP:

- **pdf_to_word** — Конвертирует PDF в редактируемый Word-документ (.docx).
file_url: публичный URL PDF-файла.
ocr: скан без текста — распознать текст (русский и английский); до 100 страниц, цена — как у ocr_pdf.
- **word_to_pdf** — Конвертирует Word-документ (.doc/.docx) в PDF.
file_url: публичный URL Word-файла.
- **merge_pdfs** — Объединяет несколько PDF в один. Порядок файлов = порядок страниц.
file_urls: список публичных URL PDF-файлов (минимум 2).
- **compress_pdf** — Сжимает PDF-файл.
file_url: публичный URL PDF-файла.
level: low | medium (по умолчанию) | high.
- **sign_pdf** — Добавляет визуальную текстовую подпись на страницу PDF.
file_url: публичный URL PDF-файла.
signature_text: текст подписи.
page: номер страницы (с 1).
x, y: координаты (0.0–1.0). width, height: размер блока (0.0–1.0).
- **jpg_to_pdf** — Конвертирует изображения (JPEG, PNG) в PDF. Каждое изображение — страница.
file_urls: список публичных URL изображений.
- **pptx_to_pdf** — Конвертирует презентацию PowerPoint (.pptx/.ppt) в PDF.
file_url: публичный URL PPTX-файла.
- **xlsx_to_pdf** — Конвертирует таблицу Excel (.xlsx/.xls) в PDF.
file_url: публичный URL XLSX-файла.
- **html_to_pdf** — Конвертирует HTML-файл в PDF.
file_url: публичный URL HTML-файла.
page_size: A4 (по умолчанию) | A3 | Letter.
orientation: portrait (по умолчанию) | landscape.
- **pdf_to_jpg** — Конвертирует страницы PDF в JPEG. Результат — ZIP-архив (page-1.jpg, page-2.jpg...).
file_url: публичный URL PDF-файла.
dpi: 72 | 150 (по умолчанию) | 300.
- **pdf_to_pptx** — Конвертирует PDF в PowerPoint (.pptx). Каждая страница — отдельный слайд.
file_url: публичный URL PDF-файла.
- **pdf_to_excel** — Извлекает таблицы из PDF и сохраняет в Excel (.xlsx).
file_url: публичный URL PDF-файла.
layout: per-table (по умолчанию) | single-sheet.
- **split_pdf** — Разделяет PDF на части. Результат — ZIP-архив с PDF-файлами.
file_url: публичный URL PDF-файла.
mode: every-page (по умолчанию) | half | ranges.
ranges: диапазоны при mode=ranges, например "1-3,5-7,10".
- **get_balance** — Возвращает баланс API аккаунта (общий для всех ключей и MCP), в рублях.
balance: остаток, ₽; spent_month: потрачено в этом месяце, ₽;
request_price: цена запроса за каждые начатые request_unit_mb МБ входа (файл до 10 МБ — один запрос);
included_remaining: сколько обычных запросов в текущем месяце тарифа ещё входит в тариф Бизнес
(месяц — от даты покупки, обновятся в included_resets_at; расходуются раньше баланса; у других тарифов 0).
- **ocr_pdf** — Распознаёт текст в сканированном PDF (OCR). Добавляет невидимый текстовый слой.
До 100 страниц за раз (больший файл сначала разделите split_pdf); цена — 1,25 ₽ за каждые 10 страниц.
file_url: публичный URL PDF-файла.
languages: список языков (например ["rus","eng"]). По умолчанию: русский + английский.
- **rotate_pdf** — Поворачивает страницы PDF.
file_url: публичный URL PDF-файла.
pages: список номеров страниц (1-based) или "all" для всех.
angle: угол поворота: 90 | 180 | 270.
- **delete_pages** — Удаляет указанные страницы из PDF.
file_url: публичный URL PDF-файла.
pages: список номеров страниц для удаления (1-based).
- **extract_pages** — Извлекает выбранные страницы в новый PDF.
file_url: публичный URL PDF-файла.
pages: список номеров страниц (1-based), порядок сохраняется.
- **reorder_pages** — Переупорядочивает страницы PDF.
file_url: публичный URL PDF-файла.
new_order: новый порядок страниц (1-based). Например [3,1,2] для 3-страничного PDF.
- **protect_pdf** — Защищает PDF паролем (AES-256).
file_url: публичный URL PDF-файла.
user_password: пароль для открытия.
owner_password: пароль владельца (опционально).
- **unlock_pdf** — Снимает парольную защиту с PDF.
file_url: публичный URL защищённого PDF.
password: пароль для снятия защиты.
- **watermark_pdf** — Добавляет водяной знак на страницы PDF.
file_url: публичный URL PDF-файла.
text: текст водяного знака (исключает image_url).
image_url: URL PNG-изображения для водяного знака (исключает text).
opacity: прозрачность 0.0–1.0 (по умолчанию 0.3).
angle: угол поворота текста (по умолчанию 45).
position: center | tile | top-left | top-right | bottom-left | bottom-right.
- **add_page_numbers** — Добавляет номера страниц в PDF.
file_url: публичный URL PDF-файла.
position: bottom-center | bottom-right | top-center | top-right.
start_from: стартовый номер (по умолчанию 1).
prefix: текст перед номером, например "Стр. " или "— ".
font_size: размер шрифта 6–72 (по умолчанию 12).
- **pdf_to_txt** — Извлекает текст из PDF в файл .txt (UTF-8).
file_url: публичный URL PDF-файла.
mode: text (по умолчанию) | blocks | words.
  text — простой текст постранично;
  blocks — текст по абзацам и колонкам;
  words — каждое слово с координатами.
- **flatten_pdf** — Сглаживает PDF (flatten): впечатывает поля форм и аннотации в страницы.
Результат нельзя редактировать — идеально для госорганов и печати.
file_url: публичный URL PDF-файла.
- **photo_to_pdf** — Собирает фото с телефона в PDF: каждое фото — страница. HEIC с iPhone тоже.
file_urls: публичные URL фото (JPG, PNG, WEBP, HEIC, TIFF, BMP), порядок = порядок страниц.
page: a4 (по умолчанию, лист A4 в ориентации фото) | photo (страница по размеру фото).
compact: уменьшить фото до 2000 px и убрать EXIF и геометку (по умолчанию да).
grayscale: оттенки серого.
scan: «Скан документа» — найти лист на фото, выровнять перспективу, белый фон.
scan_color: bw (ч/б как скан, по умолчанию) | color — только при scan.
- **pdf_to_png** — Конвертирует страницы PDF в PNG (без потерь, для схем и скриншотов). Результат — ZIP-архив.
file_url: публичный URL PDF-файла.
dpi: 72 | 150 (по умолчанию) | 300.
- **crop_pdf** — Обрезает страницы PDF. Без box — убирает белые поля автоматически.
file_url: публичный URL PDF-файла.
box: область [x0, y0, x1, y1] долями видимой страницы (0–1, от левого верхнего угла), например [0, 0, 1, 0.5] —
верхняя половина. Содержимое за краем остаётся в файле — для скрытия данных используйте redact_pdf.
pages: номера страниц (с 1) или "all".
- **edit_pdf** — Редактор PDF: добавляет на страницы текст, подпись, картинку, закрашивание, пометки и фигуры.
file_url: публичный URL PDF-файла.
objects: список объектов по порядку (последний — сверху). Координаты — доли видимой страницы (0–1, от левого
верхнего угла), box — [x0, y0, x1, y1], размеры шрифта и линий — в пунктах. У каждого объекта page (с 1) и type:
  text — box, text (переносится по ширине box), size (12), font sans|serif|mono, bold, italic, color "#RRGGBB";
  signature — box и lines (["Иванов И. И."], рукописный шрифт) или image_url (картинка подписи);
  image — box, image_url (PNG, JPG, WEBP);
  whiteout — закрасить: текст под ним удаляется из файла; color (по умолчанию чёрный, "#FFFFFF" — белый);
  highlight, rect, ellipse, check, cross — box, color, width, fill;
  line, arrow, ink — points [[x, y], ...], color, width;
  replace_text — заменить строку: box и baseline исходной строки, x начала, text (пустой — удалить строку).
Подпись через API не входит в лимит подписей сайта.
- **redact_pdf** — Скрывает персональные данные в PDF: находит и удаляет из файла (не просто закрашивает сверху) — под чёрными
прямоугольниками текста больше нет. Без areas — ищет сам.
file_url: публичный URL PDF-файла.
kinds: что искать — passport, snils, inn, phone, email, card, account (счета физлиц); по умолчанию всё.
words: свои слова — ФИО, адрес, название (каждое от 3 символов).
areas: области вручную — [{"page": 1, "box": [x0, y0, x1, y1]}] долями страницы (например, из find_personal_data).
clean: убрать скрытые данные файла — автора, свойства, комментарии, вложения (по умолчанию да).
На сканах текста нет — сначала ocr_pdf или укажите areas.
- **find_personal_data** — Находит персональные данные в PDF, файл не меняет. Номера проверяются контрольными суммами (СНИЛС, ИНН, карты).
file_url: публичный URL PDF-файла.
kinds: passport, snils, inn, phone, email, card, account; по умолчанию всё.
words: свои слова — ФИО, адрес (каждое от 3 символов).
Возвращает result: {"pages": [{"page", "items": [{"kind", "text", "boxes"}]}], "scanned": [страницы-сканы без
текста], "total"}; boxes — [x0, y0, x1, y1] долями страницы, их можно передать в redact_pdf как areas.
- **pdf_to_markdown** — Конвертирует PDF в Markdown (.md) для нейросетей, баз знаний и документации: заголовки, списки, таблицы, ссылки,
жирный и курсив.
file_url: публичный URL PDF-файла.
ocr: скан без текста — сначала распознать (русский и английский); до 100 страниц, цена — как у ocr_pdf.
- **grayscale_pdf** — Переводит PDF в оттенки серого (ч/б) — для печати и требований «только ч/б». Текст остаётся текстом.
file_url: публичный URL PDF-файла.
- **pdf_to_pdfa** — Конвертирует PDF в PDF/A — формат долговременного хранения (архивы, суды, госорганы).
file_url: публичный URL PDF-файла.
version: 1 (PDF/A-1b) | 2 (PDF/A-2b, по умолчанию) | 3 (PDF/A-3b).
- **repair_pdf** — Восстанавливает повреждённый PDF, который не открывается или открывается с ошибкой.
file_url: публичный URL PDF-файла.
- **djvu_to_pdf** — Конвертирует книгу или скан DjVu в PDF.
file_url: публичный URL DjVu-файла.
- **fb2_to_pdf** — Конвертирует книгу FB2 в PDF с оглавлением.
file_url: публичный URL FB2-файла.
page: a5 (по умолчанию, как книга) | a4.
- **epub_to_pdf** — Конвертирует книгу EPUB в PDF с оглавлением.
file_url: публичный URL EPUB-файла.
page: a5 (по умолчанию, как книга) | a4.
- **heic_to_jpg** — Конвертирует фото HEIC/HEIF с iPhone в JPG. Одно фото — JPG, несколько — ZIP-архив.
file_urls: публичные URL фото HEIC.
compact: уменьшить до 2000 px.
keep_metadata: сохранить данные съёмки (EXIF: дата, камера, геометка).
- **compress_image** — Сжимает фото (JPG, PNG, WEBP, HEIC). Одно фото — файл, несколько — ZIP-архив.
file_urls: публичные URL фото.
level: light (высокое качество) | medium (по умолчанию, до 2560 px) | strong (до 1600 px).
target_kb: сжать до размера в КБ (10–50000), тогда level не используется.
- **resize_image** — Меняет размер фото (JPG, PNG, WEBP, HEIC, TIFF, BMP), формат сохраняется. Одно фото — файл, несколько — ZIP.
file_urls: публичные URL фото.
percent: масштаб в процентах (1–500; по умолчанию 50) — или width и/или height в пикселях.
keep_aspect: сохранить пропорции (по меньшему масштабу).
enlarge: разрешить увеличение (по умолчанию фото меньше заданного не растягиваются).
- **rotate_image** — Поворачивает и отражает фото, формат сохраняется. Одно фото — файл, несколько — ZIP.
file_urls: публичные URL фото.
angle: 0 | 90 (по умолчанию) | 180 | 270 — по часовой.
flip: horizontal | vertical — отражение после поворота.
- **crop_image** — Обрезает фото по рамке, формат сохраняется.
file_url: публичный URL фото.
box: [x0, y0, x1, y1] долями кадра (0–1, от левого верхнего угла; фото повёрнуто по EXIF).
- **word_to_jpg** — Конвертирует документ Word (DOC, DOCX, ODT, RTF) в картинки JPG: одна страница — JPG, несколько — ZIP.
file_url: публичный URL документа.
dpi: 72 | 150 (по умолчанию) | 300.
- **image_to_text** — Распознаёт текст на фото и картинках (OCR): текст всех фото — в один TXT или DOCX.
Цена — как у ocr_pdf: 1,25 ₽ за каждые 10 фото (или 10 МБ).
file_urls: публичные URL фото (JPG, PNG, WEBP, HEIC, TIFF, BMP).
languages: rus, eng, deu, fra; по умолчанию ["rus", "eng"].
format: txt (по умолчанию, строки как на фото) | docx (абзацы).
- **png_to_jpg** — Конвертирует PNG в JPG (прозрачность — белый фон). Одна картинка — JPG, несколько — ZIP.
file_urls: публичные URL картинок PNG.
- **jpg_to_png** — Конвертирует JPG в PNG. Одна картинка — PNG, несколько — ZIP.
file_urls: публичные URL картинок JPG.
- **webp_to_jpg** — Конвертирует WEBP в JPG. Одна картинка — JPG, несколько — ZIP.
file_urls: публичные URL картинок WEBP.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What SmartPDF MCP server does

SmartPDF MCP server exposes PDF and photo-processing operations to AI agents through MCP. The repository describes 47 operations, including conversions between PDF, Word, PowerPoint, Excel, JPG, PNG, and image formats, as well as OCR, compression, merging, splitting, page editing, redaction, signatures, watermarks, passwords, and document metadata cleanup.

The available operations cover both document transformation and page-level changes. Agents can extract, delete, rotate, reorder, or crop pages; add page numbers or annotations; flatten forms and comments; and export PDF text in plain, block, or word-coordinate modes. Photo workflows can assemble JPG, PNG, WEBP, HEIC, TIFF, and BMP files into PDFs, optionally applying scanning, grayscale, resizing, and EXIF removal.

## How it works

The hosted MCP endpoint is `https://mcp.smartpdf.ru/mcp` and uses Streamable HTTP. Authentication is supplied with an API key through either an `Authorization: Bearer` header or an `X-API-Key` header. Most MCP tools receive public URLs rather than local file paths and return a link to the processed file.

Operations expose parameters for common variations. For example, OCR accepts language codes and supports up to 100 pages per request; PDF-to-image tools accept 72, 150, or 300 DPI; and HTML-to-PDF supports A4, A3, or Letter in portrait or landscape orientation. The `get_balance` tool reports account balance, monthly spending, request pricing, and remaining included requests.

## Setup and configuration

Create an account at SmartPDF, confirm the email address, and generate an API key beginning with `sk_live_` in the API and MCP section. The repository states that email confirmation adds 300 ₽ to the API balance. The service is billed per request in rubles, with pricing and plan details provided through the developer portal.

Claude Code can install the repository plugin through its marketplace commands. Cursor has a repository plugin and an MCP configuration, or can connect directly to the hosted endpoint. Other documented configurations include Claude Desktop, VS Code, Codex CLI, Gemini CLI, Windsurf, Cline, n8n, and Make. For local files, the repository also includes an Agent Skill and a Python 3 script that calls the REST API; that workflow uses the `SMARTPDF_API_KEY` environment variable.

## Tools and capabilities

The listed MCP tools support:

- Office, image, HTML, and PDF conversion in both directions where supported.
- OCR for Russian and English, including invisible text layers in scanned PDFs.
- Compression, merging, splitting, extraction, deletion, rotation, reordering, cropping, and page numbering.
- Text extraction, PDF editing, visual signatures, watermarks, annotations, and image placement.
- AES-256 password protection, password removal, flattening, and personal-data redaction.
- PDF-to-JPG and PDF-to-PNG exports as ZIP archives, plus Excel extraction from PDF tables.

## Limitations and notes

MCP file inputs must be publicly accessible URLs, and the documented file limit is 100 MB. OCR is limited to 100 pages per request; larger documents should be split first. Cropping does not remove content outside the visible crop, so redaction should be used when data must be removed from the file. The service runs on servers in Moscow, uses ruble billing, and is governed by the service offer rather than the repository license. Repository files are licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/smartpdf/readme_