fakturka-api-mcp
MCP-сервер Faktuj
Интегрируйте Faktuj в Claude, Cursor, VS Code и любой другой ИИ-ассистент с поддержкой MCP. Создавайте счета-фактуры (VAT) и счета-проформы, ищите компании по NIP, проверяйте курсы валют NBP и проверяйте номера IBAN — всё прямо из вашего рабочего процесса с ИИ. Полное соответствие требованиям KSeF.
API-ключ не требуется. Бесплатно навсегда.
Быстрый старт
Добавьте в ваш claude_desktop_config.json:
{
"mcpServers": {
"faktuj": {
"command": "npx",
"args": ["-y", "faktuj-mcp"]
}
}
}Или установите глобально:
npm install -g faktuj-mcpЗатем добавьте в конфигурацию:
{
"mcpServers": {
"faktuj": {
"command": "faktuj-mcp"
}
}
}Related MCP server: mcp-ksef-pl
Доступные инструменты
Инструмент | Описание |
| Создание PDF-файла польского счета-фактуры (VAT). Передайте полный JSON счета с данными продавца, покупателя и позициями. Возвращает номер счета и PDF в формате base64. |
| Создание PDF-файла счета-проформы. Схема такая же, как у счета-фактуры. Возвращает номер счета и PDF в формате base64. |
| Предварительный просмотр и проверка данных счета без создания PDF. Возвращает проверенные данные или ошибки валидации. |
| Поиск польской компании по идентификационному номеру налогоплательщика (NIP). Возвращает название компании, адрес и регистрационные данные. |
| Поиск курса валют NBP (Национального банка Польши) для заданной валюты и даты. |
| Проверка номера IBAN. Возвращает результат проверки и банковские реквизиты, если номер корректен. |
Примеры использования
Спросите вашего ИИ-ассистента:
"Создай счет-фактуру (VAT) от ACME sp. z o.o. (NIP: 1234567890) для Beta S.A. за 10 часов консультаций по 200 PLN/ч"
"Найди компанию с NIP 5263442510"
"Какой был курс EUR/PLN на 2026-03-20?"
"Проверь IBAN PL61109010140000071219812874"
Архитектура
AI Assistant <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST APIЭто тонкий транспортный слой MCP (stdio) поверх REST API Faktuj. MCP-сервер преобразует вызовы инструментов в HTTP-запросы и возвращает структурированные ответы.
Конфигурация
Переменная окружения | По умолчанию | Описание |
|
| Базовый URL для API Faktuj |
Ресурсы
Руководство по счетам-фактурам (VAT) — Как создать соответствующий польским требованиям счет-фактуру
Руководство по счетам-проформам — Когда и как использовать счета-проформы
Соответствие KSeF — Требования Национальной системы электронных счетов-фактур Польши
Блог — Руководства по выставлению счетов, налоговые советы и обновления продукта
Документация API — Полная справочная информация по REST API
Экосистема SoftVoyagers
Faktuj является частью портфолио проектов с открытым исходным кодом SoftVoyagers:
Продукт | Описание | Веб-сайт |
LinkMeta | Бесплатный API для извлечения метаданных URL | |
PageShot | Бесплатный API для создания скриншотов и захвата веб-страниц | |
PDFSpark | Бесплатный API для конвер |
This server cannot be deployed
Maintenance
Related MCP Connectors
Free Polish VAT invoice generator API (Faktura VAT). Generate professional PDF invoices with light/dark themes. No API keys required.
Fakturownia.pl (Polish invoicing) via MCP: invoices, clients, products, warehouse. Full read-write.
wFirma.pl (Polish accounting) via MCP: invoices, contractors, payments, reports. Full read-write.
Hosted MCP server for Mini Accountant: invoices, expenses, customers, analytics, tax estimates.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.645 npm2MIT
- AlicenseAqualityCmaintenanceModel Context Protocol (MCP) server for Polish Electronic Invoicing (KSeF / FA(2)). Provides tools to validate, generate, and explore API specifications for KSeF interoperability.103Apache 2.0
- FlicenseBqualityCmaintenanceSingle-tenant MCP server for Polish KSeF e-invoice workflows, supporting local stdio testing, draft management, and invoice submission with safety gates.23-
- AlicenseNot gradedqualityDmaintenanceMCP server for the Invapi E-Invoicing API, enabling conversion, validation, and extraction of invoices in UBL, CII, ZUGFeRD, Excel, and more.48 npmMIT