InvoiceFlow MCP

Автоматизация счетов на базе ИИ для протокола Model Context Protocol

InvoiceFlow создает профессиональные PDF-счета, прогнозирует риск задержки платежа с помощью ИИ, автоматически отправляет напоминания, сопоставляет входящие платежи со счетами и отслеживает ваш денежный поток — и все это через протокол MCP.

Функции

• Профессиональные PDF-счета с товарными позициями, налогами, скидками, поддержкой нескольких валют (10 валют)

• ИИ-прогнозирование рисков (0-100) на основе суммы счета, истории клиента, срока оплаты, истории напоминаний

• Умные напоминания с эскалацией в зависимости от уровня риска

• Сверка платежей, сопоставляющая входящие платежи со счетами по сумме + email плательщика (не зависит от платформы — работает с данными платежей, введенными вручную или через вебхуки)

• Отчетность по денежным потокам с показателями собираемости, прогнозируемым доходом, разбивкой по клиентам

• Управление клиентами с автоматическим отслеживанием истории платежей

• Последовательные номера счетов (INV-2026-0001, INV-2026-0002, ...)

• 10 инструментов MCP + 4 ресурса MCP, охватывающих весь жизненный цикл выставления счетов

Related MCP server: Frihet MCP Server

Быстрый старт

Установка из маркетплейса MCPize

1. Найдите InvoiceFlow MCP на mcpize.com

2. Нажмите Install и выберите тариф подписки

3. Инструменты и ресурсы автоматически станут доступны в любом MCP-совместимом клиенте

Сборка из исходного кода

git clone https://github.com/enzoemir1/invoiceflow-mcp.git
cd invoiceflow-mcp
npm ci
npm run build

Добавьте в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "invoiceflow": {
      "command": "node",
      "args": ["path/to/invoiceflow-mcp/dist/index.js"]
    }
  }
}

Инструменты

client_manage

Создание нового клиента. Требуется перед созданием счетов.

invoice_create

Создание счета с товарными позициями. Автоматически рассчитывает промежуточный итог, налог, скидки и общую сумму. Генерирует последовательные номера счетов (INV-YYYY-NNNN).

invoice_send

Отправка PDF-счета по электронной почте (требуется SENDGRID_API_KEY). Обновляет статус на "sent" (отправлено).

invoice_list

Фильтрация счетов по статусу, клиенту, диапазону сумм, диапазону дат или статусу просрочки. Поддерживает пагинацию.

invoice_mark_paid

Отметка счета как оплаченного (полностью или частично). Автоматически обновляет историю платежей клиента.

invoice_remind

Отправка напоминания об оплате. Увеличивает счетчик напоминаний. Поддерживает пользовательские сообщения.

invoice_risk

ИИ-прогнозирование риска задержки платежа (0-100). Возвращает уровень риска, разбивку факторов, рекомендуемое действие, дату следующего напоминания.

cashflow_report

Генерация сводки денежных потоков: общая сумма выставленных счетов, полученных средств, задолженности, просроченных платежей, коэффициент собираемости, 30-дневный прогноз.

payment_reconcile

Сопоставление входящего платежа со счетом по сумме и email плательщика. Автоматически помечает как оплаченный.

Ресурсы

Механизм прогнозирования рисков

Оценивает счета от 0 до 100, используя 4 взвешенных фактора:

Уровни риска: Низкий (0-30), Средний (31-60), Высокий (61-100)

Конфигурация

Скопируйте .env.example в .env и установите необходимые переменные:

cp .env.example .env

SendGrid является опциональным. InvoiceFlow полностью работает в автономном режиме для создания счетов, оценки рисков, отчетности по денежным потокам и сверки. Добавьте SendGrid, если хотите отправлять электронные письма.

Дорожная карта: живая синхронизация Stripe и PayPal

Инструмент payment_reconcile в настоящее время сопоставляет суммы, которые вы предоставляете (из CSV, вебхука или ручного ввода), с сохраненными счетами. Прямая интеграция API Stripe и PayPal с прослушивателями вебхуков запланирована на версию 2.0 — следите за прогрессом в issues.

Примеры использования

Создание клиента и счета

> Create a client "Acme Corp" with email billing@acme.com

✓ Client created: Acme Corp (id: 3f2a...)

> Create an invoice for Acme Corp: 10 hours consulting at $150/hr, 20% tax

✓ Invoice INV-2026-0001 created
  Subtotal: $1,500.00 | Tax: $300.00 | Total: $1,800.00

Оценка риска платежа

> What's the risk score for invoice INV-2026-0001?

Risk Score: 42/100 (Medium)
  - Invoice Amount: 25 (moderate amount)
  - Client History: 50 (new client)
  - Due Date: 15 (due in 28 days)
  - Reminders: 10 (none sent)
Recommended: Send an early reminder with a polite tone.

Генерация отчета о денежных потоках

> Show me the cash flow report

April 2026:
  Total Invoiced: $12,400.00
  Collected: $8,200.00 (66.1%)
  Outstanding: $4,200.00
  Overdue: $1,800.00
  Projected (30d): $2,400.00

Поддерживаемые валюты

USD, EUR, GBP, CAD, AUD, JPY, CHF, TRY, BRL, INR

Цены

Доступно на маркетплейсе MCPize.

Разработка

npm run dev        # Hot reload
npm run build      # Production build
npm test           # Run tests
npm run inspect    # MCP Inspector

Тестирование

Тесты охватывают основную бизнес-логику:

• Хранилище — операции CRUD, фильтрация, последовательные номера счетов

• Модель рисков — механизм ИИ-оценки с 4 взвешенными факторами, классификация рисков

• Денежный поток — генерация отчетов, коэффициенты собираемости, прогнозы, разбивка по клиентам

npm test           # Run all tests
npx vitest --watch # Watch mode

Лицензия Pro

InvoiceFlow поставляется в бесплатном режиме — invoice_demo_seed, client_manage, invoice_create, invoice_list, invoice_mark_paid и invoice_remind открыты. Следующие инструменты требуют лицензию Pro:

• invoice_send — создание PDF + отправка через SendGrid

• invoice_risk — прогнозирование риска задержки платежа

• payment_reconcile — сопоставление платежей Stripe/PayPal/банковских платежей со счетами

• cashflow_report — денежный поток по всему портфелю + 30-дневный прогноз

Купить лицензию Pro (€12, пожизненная, 3 машины): https://automatiabcn.lemonsqueezy.com/buy/2d439c05-f463-4137-8883-950e8ee1112d

Или получите комплект Indie MCP Stack Bundle (€69, все 4 сервера).

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

Или в конфигурации вашего MCP-клиента:

{
  "mcpServers": {
    "invoiceflow-mcp": {
      "command": "npx",
      "args": ["-y", "invoiceflow-mcp-server"],
      "env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
    }
  }
}

Валидация кэшируется локально на 24 часа — полностью работает в автономном режиме после первого запуска.

Лицензия

Лицензия MIT. Подробности см. в LICENSE.

Создано Automatia BCN.