English Français العربية

SmartPDF

Official registry Productivity

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http smartpdf 'https://mcp.smartpdf.ru/mcp' --header 'Authorization: <SmartPDF API key with the Bearer prefix>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "smartpdf": {
            "type": "http",
            "url": "https://mcp.smartpdf.ru/mcp",
            "headers": {
                "Authorization": "<SmartPDF API key with the Bearer prefix>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. SmartPDF для ИИ-агентов
  2. Ключ
  3. Claude Code — плагин
  4. Cursor
  5. Только MCP-сервер
  6. Навык в других агентах
  7. English
  8. Лицензия

SmartPDF для ИИ-агентов

47 операций с PDF и фото для Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code и других агентов: конвертация в PDF и из PDF (в том числе Markdown, DjVu, FB2, EPUB), сжатие, объединение и разделение, распознавание текста (в том числе русского), редактор PDF, поиск и удаление персональных данных, страницы, подпись, водяной знак, пароль, инструменты для фото. Серверы в Москве, оплата в рублях за запрос.

Портал для разработчиков · Документация · llms.txt

ЧтоГде
Плагин Claude Code: MCP-сервер и навык.claude-plugin/
Плагин Cursor: MCP-сервер и навык.cursor-plugin/, mcp.json
Навык (Agent Skill) для любого агента: инструкция, скрипт для файлов с диска, справочник параметровskills/smartpdf/
Описание для реестра MCPserver.json

Ключ

Зарегистрируйтесь на smartpdf.ru и подтвердите почту — на баланс API придёт 300 ₽. Ключ sk_live_… создаётся в личном кабинете, в разделе «API и MCP». Цена запроса и бонусы при пополнении — на dev.smartpdf.ru.

Claude Code — плагин

/plugin marketplace add kirmoz1997/smartpdf-agents
/plugin install smartpdf@smartpdf

Claude Code спросит ключ и сохранит его в защищённом хранилище системы. После установки агенту доступны инструменты SmartPDF для файлов по ссылкам и навык smartpdf для файлов с диска — ему нужна ещё переменная окружения SMARTPDF_API_KEY с тем же ключом.

Из терминала: claude plugin marketplace add kirmoz1997/smartpdf-agents, затем claude plugin install smartpdf@smartpdf --config api_key=sk_live_….

Cursor

Плагин для Cursor (MCP-сервер и навык) — в этом же репозитории (.cursor-plugin/, mcp.json); ключ задаётся в Plugins → Configure. Только MCP-сервер — одной ссылкой: Добавить в Cursor (ключ — из переменной окружения SMARTPDF_API_KEY).

Только MCP-сервер
Адресhttps://mcp.smartpdf.ru/mcp
ТранспортStreamable HTTP
КлючAuthorization: Bearer sk_live_… или X-API-Key: sk_live_…

Сервер есть в официальном реестре MCP под именем ru.smartpdf/smartpdf.

Готовые конфиги для Claude Desktop, Cursor, VS Code, Codex CLI, Gemini CLI, Windsurf, Cline, n8n и Make — в документации. Инструменты принимают публичные ссылки на файлы до 100 МБ и возвращают ссылку на результат.

Навык в других агентах

Навык работает и с MCP-инструментами, и без них: файлы с диска он обрабатывает скриптом scripts/smartpdf.py через REST API (нужен Python 3, ключ — в SMARTPDF_API_KEY). Скопируйте папку skills/smartpdf туда, где агент ищет навыки:

git clone https://github.com/kirmoz1997/smartpdf-agents
cp -R smartpdf-agents/skills/smartpdf ~/.agents/skills/
АгентПапка навыков
Codex CLI~/.agents/skills/ или .agents/skills/ в проекте
Gemini CLI.gemini/skills/ или .agents/skills/ в проекте
Cursor.cursor/skills/ или .agents/skills/ в проекте
VS Code (Copilot).github/skills/ или .agents/skills/ в проекте
Claude Code без плагина~/.claude/skills/ или .claude/skills/ в проекте

Скрипт можно запускать и самому:

export SMARTPDF_API_KEY=sk_live_…
python3 skills/smartpdf/scripts/smartpdf.py compress report.pdf -p level=high
python3 skills/smartpdf/scripts/smartpdf.py operations

English

SmartPDF is a Russian PDF service (servers in Moscow, billing in rubles per request). This repository contains a Claude Code plugin (remote MCP server + agent skill), a standalone Agent Skill with a stdlib-only Python script for local files, and server.json for the official MCP Registry.

  • MCP: https://mcp.smartpdf.ru/mcp, Streamable HTTP, Authorization: Bearer <API key>; 47 tools that take public file URLs and return a download link, plus get_balance. Official MCP Registry: ru.smartpdf/smartpdf.
  • Claude Code: /plugin marketplace add kirmoz1997/smartpdf-agents, then /plugin install smartpdf@smartpdf.
  • Cursor: plugin in .cursor-plugin/ + mcp.json (key in Plugins → Configure), or Add to Cursor.
  • API keys: smartpdf.ru — 300 ₽ of free balance after email confirmation.
  • Documentation (in Russian): dev.smartpdf.ru/docs, llms.txt. Contact: smartpdf@yandex.ru.

Лицензия

Файлы этого репозитория — MIT. Работа сервиса — по оферте.

Frequently asked questions

What is SmartPDF?

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

How do I install SmartPDF?

It runs as a remote server. In Claude Code: claude mcp add --transport http smartpdf 'https://mcp.smartpdf.ru/mcp' --header 'Authorization: <SmartPDF API key with the Bearer prefix>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does SmartPDF need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is SmartPDF open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains SmartPDF?

It is published by kirmoz1997. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.