SmartPDF

ru.smartpdfv1.0.0Updated Oct 4, 2026

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

VerifiedStreamable HTTPWeb executableFiles & StorageProductivity & Workflow

Overview

AI-generated overview

SmartPDF is a remote MCP server offering 24 PDF operations such as conversion, compression, merging, OCR, signing and watermarking.

What it does
It exposes 24 PDF tools that accept public file URLs up to 100 MB and return a download link, covering conversion to and from Office and JPG, compression, merging and splitting, OCR (including Russian), page handling, signing, watermarking and password protection. A get_balance tool reports the remaining API balance. The service runs on servers in Moscow and bills per request in rubles.
When to use it
Use it when an assistant needs to process PDFs without local tooling: converting documents, shrinking large files, combining or splitting them, running OCR on scans, or applying signatures and watermarks. It suits agents that work with files reachable by public URL rather than local disk contents.
Requirements
A remote Streamable HTTP endpoint at An API key is required, sent as the Authorization header with the Bearer prefix (or as X-API-Key). Keys are created in the smartpdf.ru account area after registration and email confirmation; a 300 ruble starting balance is credited. The optional local skill script needs Python 3 and the SMARTPDF_API_KEY environment variable.
Before you install
The Authorization header carries a live API key (sk_live_ prefix) that must be kept secret. Usage is billed per request in rubles, so calls spend account balance. Tools take public file URLs and return download links, meaning the files are uploaded to a third-party Russian service and results are exposed via link. Signing, watermarking and password operations modify documents.

Installation

In SourceWeft

  1. Open SmartPDF in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "smartpdf": {
      "type": "http",
      "url": "https://mcp.smartpdf.ru/mcp"
    }
  }
}

README

[SmartPDF]

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

24 операции с PDF для Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code и других агентов: конвертация в PDF и из 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 туда, где агент ищет навыки:

bash
git clone https://github.com/kirmoz1997/smartpdf-agentscp -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/ в проекте

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

bash
export SMARTPDF_API_KEY=sk_live_…python3 skills/smartpdf/scripts/smartpdf.py compress report.pdf -p level=highpython3 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>; 24 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: [email protected].

Лицензия

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

Source: README.md at commit cf2aa00

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 4, 2026