Skip to main content
Glama
deenesjakoruzh
softvoyagers

fakturka-api-mcp

by softvoyagers
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Servidor MCP Faktuj

npm version Website API Status

Integra Faktuj en Claude, Cursor, VS Code y cualquier asistente de IA compatible con MCP. Genera facturas de IVA y facturas proforma, busca empresas por NIP, consulta los tipos de cambio del NBP y valida números IBAN, todo desde tu flujo de trabajo de IA. Totalmente alineado con los requisitos de cumplimiento de KSeF.

No requiere clave API. Gratis para siempre.

Inicio rápido

Añádelo a tu claude_desktop_config.json:

{
  "mcpServers": {
    "faktuj": {
      "command": "npx",
      "args": ["-y", "faktuj-mcp"]
    }
  }
}

O instálalo globalmente:

npm install -g faktuj-mcp

Luego añádelo a tu configuración:

{
  "mcpServers": {
    "faktuj": {
      "command": "faktuj-mcp"
    }
  }
}

Related MCP server: mcp-ksef-pl

Herramientas disponibles

Herramienta

Descripción

generate_invoice

Genera un PDF de factura de IVA polaca. Pasa el JSON completo de la factura con el vendedor, el comprador y las partidas. Devuelve el número de factura y el PDF en base64.

generate_proforma

Genera un PDF de factura proforma. Mismo esquema que la factura de IVA. Devuelve el número de factura y el PDF en base64.

preview_invoice

Previsualiza y valida los datos de la factura sin generar un PDF. Devuelve los datos validados o errores de validación.

lookup_nip

Busca una empresa polaca por su número de identificación fiscal NIP. Devuelve el nombre de la empresa, la dirección y los datos de registro.

lookup_nbp_rate

Consulta el tipo de cambio del NBP (Banco Nacional de Polonia) para una moneda y fecha determinadas.

validate_iban

Valida un número IBAN. Devuelve el resultado de la validación y los detalles bancarios si es válido.

Ejemplo de uso

Pregunta a tu asistente de IA:

  • "Genera una factura de IVA de ACME sp. z o.o. (NIP: 1234567890) a Beta S.A. por 10 horas de consultoría a 200 PLN/h"

  • "Busca la empresa con NIP 5263442510"

  • "¿Cuál fue el tipo de cambio EUR/PLN el 20-03-2026?"

  • "Valida el IBAN PL61109010140000071219812874"

Arquitectura

AI Assistant <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST API

Esta es una capa de transporte MCP stdio ligera sobre la API REST de Faktuj. El servidor MCP traduce las llamadas a herramientas en solicitudes HTTP y devuelve respuestas estructuradas.

Configuración

Variable de entorno

Predeterminado

Descripción

FAKTUJ_API_URL

https://faktuj.pl

URL base para la API de Faktuj

Recursos

Ecosistema SoftVoyagers

Faktuj es parte de la cartera de código abierto de SoftVoyagers:

Producto

Descripción

Sitio web

LinkMeta

API gratuita de extracción de metadatos de URL

linkmeta.dev

PageShot

API gratuita de captura de pantalla y páginas web

pageshot.site

PDFSpark

API gratuita de conversión de HTML/URL a PDF

pdfspark.dev

OGForge

API gratuita de generación de imágenes Open Graph

ogforge.dev

LinkShrink

API gratuita de acortamiento de URL centrada en la privacidad

linkshrink.dev

Faktuj

Generador gratuito de facturas de IVA polacas

faktuj.pl

QRMint

Generador y API de códigos QR estilizados gratuitos

qrmint.dev

PageDrop

API gratuita de alojamiento instantáneo de HTML

pagedrop.dev

PismoSzyteNaMiarę

Darmowy generator pism urzędowych

pismoszytenamiare.pl

Licencia

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • einvoice-mcp

    makririch
    A
    license
    A
    quality
    D
    maintenance
    MCP 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.
    6
    45 npm
    2
    MIT

  • mcp-ksef-pl

    cmendezs
    A
    license
    A
    quality
    C
    maintenance
    Model Context Protocol (MCP) server for Polish Electronic Invoicing (KSeF / FA(2)). Provides tools to validate, generate, and explore API specifications for KSeF interoperability.
    10
    3
    Apache 2.0

  • @invapi/mcp-server

    invapi-org
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for the Invapi E-Invoicing API, enabling conversion, validation, and extraction of invoices in UBL, CII, ZUGFeRD, Excel, and more.
    48 npm
    MIT