MCP Server

InvoiceForge

com.agenttoolworks/invoiceforge
Business & Operations Legal & Compliance Public & reachable MCP 2025-11-25

What this MCP does

Generates, validates, and reads EN 16931 and Peppol BIS 3.0 electronic invoices in UBL and CII formats.

describe_coverage
List what this server checks and what it does not do
Returns the exact EN 16931 rules this server checks, the syntaxes it can produce and read, and the things it deliberately does not do, such as transmitting invoices over Peppol or acting as a French accredited platform. Light read: costs 0.2 credit.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
extract_invoice
Read an invoice document into structured data
Reads an incoming UBL or CII (Factur-X) invoice XML and returns the data as structured JSON, listing any field the document did not contain rather than guessing it. Use it to ingest supplier invoices before booking them. Costs 1 credit.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['xml'], 'properties': {'xml': {'type': 'string', 'minLength': 40, 'description': 'The invoice XML, UBL 2.1 or CII'}}, 'additionalProperties': False}
generate_invoice
Generate a compliant e-invoice
Turns invoice data into a compliant UBL 2.1 XML document following the EN 16931 semantic model, with totals and the VAT breakdown computed for you. Choose the plain EN 16931 profile or the Peppol BIS Billing 3.0 customization. The document is validated before it is returned, so you never get back XML that would be rejected. Costs 1 credit.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice'], 'properties': {'invoice': {'type': 'object', 'required': ['invoiceNumber', 'issueDate', 'currency', 'seller', 'buyer', 'lines'], 'properties': {'buyer': {'type': 'object', 'required': ['name', 'countryCode'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string', 'minLength': 1, 'description': 'Legal name of the party'}, 'vatId': {'type': 'string', 'description': "VAT identifier, e.g. 'FR40303265045'"}, 'legalId': {'type': 'string', 'description': 'Legal registration id, e.g. SIREN'}, 'postalCode': {'type': 'string'}, 'addressLine': {'type': 'string'}, 'countryCode': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': "ISO 3166-1 alpha-2, e.g. 'FR'"}}, 'additionalProperties': False}, 'lines': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'quantity', 'unitPrice', 'netAmount'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string', 'minLength': 1, 'description': 'Item name'}, 'vatRate': {'type': 'number'}, 'quantity': {'type': 'number'}, 'unitCode': {'type': 'string', 'default': 'C62'}, 'netAmount': {'type': 'number'}, 'unitPrice': {'type': 'number'}, 'vatCategory': {'type': 'string', 'default': 'S', 'description': "VAT category code, e.g. 'S' standard, 'Z' zero, 'E' exempt"}}, 'additionalProperties': False}, 'minItems': 1}, 'seller': {'type': 'object', 'required': ['name', 'countryCode'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string', 'minLength': 1, 'description': 'Legal name of the party'}, 'vatId': {'type': 'string', 'description': "VAT identifier, e.g. 'FR40303265045'"}, 'legalId': {'type': 'string', 'description': 'Legal registration id, e.g. SIREN'}, 'postalCode': {'type': 'string'}, 'addressLine': {'type': 'string'}, 'countryCode': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': "ISO 3166-1 alpha-2, e.g. 'FR'"}}, 'additionalProperties': False}, 'dueDate': {'type': 'string'}, 'currency': {'type': 'string', 'maxLength': 3, 'minLength': 3, 'description': "ISO 4217, e.g. 'EUR'"}, 'typeCode': {'type': 'string', 'default': '380'}, 'issueDate': {'type': 'string', 'description': "ISO date, e.g. '2026-09-01'"}, 'payeeIban': {'type': 'string'}, 'paymentTerms': {'type': 'string'}, 'invoiceNumber': {'type': 'string', 'minLength': 1}, 'prepaidAmount': {'type': 'number'}, 'vatExemptions': {'type': 'array', 'items': {'type': 'object', 'required': ['category'], 'properties': {'category': {'type': 'string', 'minLength': 1, 'description': "VAT category code the reason applies to, e.g. 'AE'"}, 'reasonCode': {'type': 'string', 'description': "VATEX code, e.g. 'VATEX-EU-AE'"}, 'reasonText': {'type': 'string', 'description': "Reason in words, e.g. 'Reverse charge'. Either text or code is enough."}}, 'additionalProperties': False}}, 'buyerReference': {'type': 'string'}}, 'description': 'The invoice to produce', 'additionalProperties': False}, 'profile': {'enum': ['en16931', 'peppol'], 'type': 'string', 'default': 'en16931', 'description': 'Which specification identifier to stamp on the document'}}, 'additionalProperties': False}
get_usage
Get usage and credit balance
Returns your current plan, remaining credit balance and call volume over the last 30 days. Free to call.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
validate_invoice
Check an invoice against EN 16931 rules
Checks invoice data against a documented subset of the EN 16931 business rules: mandatory fields, code lists, VAT category consistency and the arithmetic that most often gets invoices rejected. Accepts incomplete or malformed data on purpose, since that is what you want checked, and answers with each violation, its rule identifier and its business term, plus exactly which rules were checked. It never claims full compliance with the norm. Costs 1 credit.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice'], 'properties': {'invoice': {'type': 'object', 'properties': {'buyer': {'type': 'object', 'default': {'name': '', 'countryCode': ''}, 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string', 'default': ''}, 'vatId': {'type': 'string'}, 'legalId': {'type': 'string'}, 'postalCode': {'type': 'string'}, 'addressLine': {'type': 'string'}, 'countryCode': {'type': 'string', 'default': ''}}, 'additionalProperties': {}}, 'lines': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'default': ''}, 'name': {'type': 'string', 'default': ''}, 'vatRate': {'type': 'number'}, 'quantity': {'type': 'number', 'default': 0}, 'unitCode': {'type': 'string', 'default': 'C62'}, 'netAmount': {'type': 'number', 'default': 0}, 'unitPrice': {'type': 'number', 'default': 0}, 'vatCategory': {'type': 'string', 'default': 'S'}}, 'additionalProperties': {}}, 'default': []}, 'seller': {'type': 'object', 'default': {'name': '', 'countryCode': ''}, 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string', 'default': ''}, 'vatId': {'type': 'string'}, 'legalId': {'type': 'string'}, 'postalCode': {'type': 'string'}, 'addressLine': {'type': 'string'}, 'countryCode': {'type': 'string', 'default': ''}}, 'additionalProperties': {}}, 'dueDate': {'type': 'string'}, 'currency': {'type': 'string', 'default': ''}, 'typeCode': {'type': 'string', 'default': '380'}, 'issueDate': {'type': 'string', 'default': ''}, 'payeeIban': {'type': 'string'}, 'paymentTerms': {'type': 'string'}, 'invoiceNumber': {'type': 'string', 'default': ''}, 'prepaidAmount': {'type': 'number'}, 'vatExemptions': {'type': 'array', 'items': {'type': 'object', 'properties': {'category': {'type': 'string', 'default': ''}, 'reasonCode': {'type': 'string'}, 'reasonText': {'type': 'string'}}, 'additionalProperties': {}}}, 'buyerReference': {'type': 'string'}}, 'description': 'The invoice to check, however incomplete', 'additionalProperties': {}}}, 'additionalProperties': False}
Added
get_usage
Oct. 5, 2026, 2:40 a.m.
Added
describe_coverage
Oct. 5, 2026, 2:40 a.m.
Added
extract_invoice
Oct. 5, 2026, 2:40 a.m.
Added
validate_invoice
Oct. 5, 2026, 2:40 a.m.
Added
generate_invoice
Oct. 5, 2026, 2:40 a.m.