Back to Browse

Sdk MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Official MCP server for the FacturX API: dry run, Factur-X conversion, validation, rule lookup.

About

Official MCP server for the FacturX API: dry run, Factur-X conversion, validation, rule lookup.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (0 strong, 2 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

11 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

FacturX API key (free Sandbox key at https://facturxapi.com/api-key)Required

Environment variable: FACTURX_API_KEY

API base URLOptional

Environment variable: FACTURX_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "facturx-mcp": {
      "command": "uvx",
      "args": [
        "facturx-mcp==0.1.2"
      ],
      "env": {
        "FACTURX_API_KEY": "your-facturx-api-key-here",
        "FACTURX_BASE_URL": "your-facturx-base-url-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

FacturX SDK

Official clients for the FacturX API: check an invoice with a dry run, convert it to a Factur-X PDF/A-3 file, validate it — from Python, Node.js, a command line, or an MCP-compatible assistant.

DirectoryPackageRegistryWhat it is
python/facturx-apiPyPIPython client and the facturx command (dry-run, convert, validate)
node/@facturxapi/sdknpmNode.js client (ESM, TypeScript types)
mcp/facturx-mcpPyPIMCP server (registry name com.facturxapi/mcp); an npm launcher may follow
examples/——Runnable examples with their recorded output

Status: alpha. facturx-api and facturx-mcp 0.1.1 are on PyPI (pip install facturx-api, pip install facturx-mcp); @facturxapi/sdk 0.1.1 is on npm (npm install @facturxapi/sdk). See RELEASING.md.

Design choices worth knowing

  • Production by default (from 0.1.2): the host is https://api.facturxapi.com unless you pass base_url / baseUrl or set FACTURX_BASE_URL; it must be https. In 0.1.1 the host is required.
  • A final file is checked, not assumed. A dry run reads the API's generationReadiness; a conversion is only reported as done when the final file is present, not on the HTTP status alone.
  • One idempotency key per operation, and signed download URLs are fetched without your API key.
  • No automatic retry of 409 / 503 answers: the caller decides.
  • The examples in examples/ were recorded against the staging host and say so; they will move to the production host with the first release.

Tests (offline, no network, no API key)

cd python && PYTHONPATH=src python -m unittest discover -s tests -v && ruff check .
cd node && npm test
cd mcp && pip install ../python . pytest && pytest tests

Security

See SECURITY.md. Releases use trusted publishing (OIDC): no registry token is stored in this repository.

License

MIT.

Reviews

No reviews yet

Be the first to review this server!