paraguay-invoice-mcp

Let AI agents issue Paraguay electronic invoices (SIFEN e-Kuatia) — create documentos electronicos via your own FacturaSend account, query by CDC, check DNIT…

От сообществаРаботаетБез входаГлобальныйБесплатноМожет изменять данные

Что умеет

  • Create Invoice: Issue a Paraguay electronic invoice (factura electrónica, Documento Electrónico for SIFEN / e-Kuatia) through FacturaSend, which generates, digitally signs and transmits it to the DNIT
  • Query Invoice: Look up a previously-created Paraguay DE by its cdc (the 44-digit control code) OR by its FacturaSend internal id — pass exactly one of { cdc } or { id }. Wraps GET /{tenant}/de/cdc/{cd
  • Get Document Status: Consult the live SIFEN status of a Paraguay DE by its cdc — wraps POST /{tenant}/de/estado. FacturaSend queries DNIT/SIFEN and returns the estado: "Aprobado" (approved, fiscally v

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Let AI agents issue Paraguay electronic invoices (SIFEN e-Kuatia) — create documentos electronicos via your own FacturaSend account, query by CDC, check DNIT status. Stateless remote MCP server: bring your own tenant and key, IVA 10/5% computed locally, never stores data.

Как подключить

Как подключить paraguay-invoice-mcp к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://paraguay-invoice-mcp--wishpool.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить paraguay-invoice-mcp к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://paraguay-invoice-mcp--wishpool.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить paraguay-invoice-mcp к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://paraguay-invoice-mcp--wishpool.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (3)

Технические названия из tools/list. Нужны только разработчикам.

create_invoiceIssue a Paraguay electronic invoice (factura electrónica, Documento Electrónico for SIFEN / e-Kuatia) through FacturaSend, which generates, digitally signs and transmits it to the DNIT (tax authority) from YOUR OWN FacturaSend account — this server only forwards the call and never holds your certificate. It wraps POST /{tenant}/lote/create with a single DE. Amounts are in Paraguayan guaraníes (PYG), which have NO decimals — pass unit prices as INTEGERS, and prices are TAX-INCLUSIVE (IVA incluido). IVA (VAT) rate per line: 10 (standard), 5 (reduced), or 0 (exempt); the server liquidates the IVA portion locally (10% -> price*10/110, 5% -> price*5/105). Set draft=true to build the DE WITHOUT transmitting it to SIFEN (offline test, no fiscal effect). On success you get the 44-digit cdc, the numero (establecimiento-punto-numero), and the SIFEN estado (Aprobado / Aprobado con observacion / Rechazado). Required credential headers (set once in your MCP client, per-request, never stored): x-facturasend-tenant (your FacturaSend tenant/company id, in the URL path) + x-facturasend-key (your FacturaSend API key; the free test environments never reach SIFEN production). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.
query_invoiceLook up a previously-created Paraguay DE by its cdc (the 44-digit control code) OR by its FacturaSend internal id — pass exactly one of { cdc } or { id }. Wraps GET /{tenant}/de/cdc/{cdc} or GET /{tenant}/de/id/{id}. Returns the document metadata FacturaSend holds: id, cdc, fecha, situacion (SIFEN situation code), lote_id, lote_estado, and info_codigo/info_descripcion (e.g. "CDC duplicado"). To get the live SIFEN approval status use get_document_status instead. Safe to call anytime. Required credential headers (set once in your MCP client, per-request, never stored): x-facturasend-tenant (your FacturaSend tenant/company id, in the URL path) + x-facturasend-key (your FacturaSend API key; the free test environments never reach SIFEN production). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.
get_document_statusConsult the live SIFEN status of a Paraguay DE by its cdc — wraps POST /{tenant}/de/estado. FacturaSend queries DNIT/SIFEN and returns the estado: "Aprobado" (approved, fiscally valid), "Aprobado con observacion" (approved with an observation), or "Rechazado" (rejected — read respuesta_mensaje, fix, and re-issue). Also returns situacion, fecha, respuesta_codigo and respuesta_mensaje (the SIFEN message, e.g. "0260 Autorización del DE satisfactoria"). Required credential headers (set once in your MCP client, per-request, never stored): x-facturasend-tenant (your FacturaSend tenant/company id, in the URL path) + x-facturasend-key (your FacturaSend API key; the free test environments never reach SIFEN production). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.