MCP-Server

Jithox E-Invoice Readiness

com.jithox/einvoice-readiness
Recht & Compliance Payments & Fintech Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Validates EU VAT numbers and invoice structure, verifies VIES status, checks Peppol participation, and reports e-invoice readiness without sending invoices.

get_einvoice_readiness
Assess e-invoice readiness
Readiness snapshot for YOUR canary workspace: one plain state, what is ready, what is missing, and the next safe step. Diagnostics, not a compliance certificate. Validation and readiness only; never sends a Peppol invoice and gives no legal, fiscal or compliance guarantee.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {'verifyWithProvider': {'type': 'boolean', 'description': 'Also confirm the bound legal entity with the provider (one provider call).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'title': 'Jithox Fleet Trust Contract V1 — get_einvoice_readiness', 'required': ['schemaVersion', 'product', 'capability', 'decision', 'decisionCategory', 'data', 'provenance', 'limitations', 'receipt', 'billing', 'retryable', 'generatedAt'], 'properties': {'data': {'type': 'object'}, 'billing': {'type': 'object', 'required': ['billable', 'category'], 'properties': {'billable': {'type': 'boolean'}, 'category': {'enum': ['billable', 'non_billable'], 'type': 'string'}}, 'additionalProperties': False}, 'product': {'const': 'com.jithox/einvoice-readiness'}, 'receipt': {'oneOf': [{'type': 'null'}, {'type': 'object', 'required': ['receiptId', 'keyId', 'signature', 'publicKeyUrl'], 'properties': {'keyId': {'type': 'string'}, 'receiptId': {'type': 'string'}, 'signature': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}}, 'additionalProperties': False}]}, 'decision': {'enum': ['ready', 'not_ready', 'needs_review', 'unavailable'], 'type': 'string'}, 'retryable': {'type': 'boolean'}, 'capability': {'const': 'get_einvoice_readiness'}, 'provenance': {'type': 'object', 'required': ['source', 'date', 'checksum', 'freshness'], 'properties': {'date': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'checksum': {'type': ['string', 'null']}, 'freshness': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'generatedAt': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'schemaVersion': {'const': 'jithox.fleet-trust-contract/v1'}, 'receiptEnvelope': {'type': 'object', 'required': ['receiptVersion', 'canonicalizationVersion', 'algorithm', 'keyId', 'payload', 'signature', 'publicKeyUrl', 'verificationUrl'], 'properties': {'keyId': {'type': 'string'}, 'payload': {'type': 'object'}, 'algorithm': {'type': 'string'}, 'signature': {'type': 'string'}, 'resultHash': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}, 'receiptVersion': {'type': 'string'}, 'verificationUrl': {'type': 'string'}, 'canonicalizationVersion': {'type': 'string'}}, 'additionalProperties': False}, 'decisionCategory': {'enum': ['proceed', 'review', 'blocked', 'no_result', 'invalid_input', 'unavailable', 'stale'], 'type': 'string'}}, 'additionalProperties': False}
lookup_peppol_participant
Look up a Peppol participant
Check whether a receiver is registered on the Peppol network and accepts BIS Billing 3.0 invoices, via the official SML/SMP discovery route when enabled (otherwise an honest mock that says so). Only status registered/not_registered is definitive; unavailable/not_configured are truthful and never a hidden "no". Provide vatId or endpointId (at least one) plus the receiver country. Lookup only — never a send action, and no send tool exists here. Validation and readiness only; never sends a Peppol invoice and gives no legal, fiscal or compliance guarantee.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['countryCode'], 'properties': {'vatId': {'type': 'string', 'maxLength': 60, 'minLength': 4, 'description': 'VAT / enterprise number, e.g. "BE0123456749".'}, 'endpointId': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Peppol endpoint identifier (GLN or scheme-specific id).'}, 'countryCode': {'enum': ['AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GB', 'GR', 'HU', 'IE', 'IS', 'IT', 'LI', 'LT', 'LU', 'LV', 'MT', 'NL', 'NO', 'PL', 'PT', 'RO', 'SE', 'SI', 'SK'], 'type': 'string', 'description': 'Receiver country (drives the scheme derivation).'}, 'endpointScheme': {'type': 'string', 'maxLength': 10, 'minLength': 1, 'description': 'EAS scheme id. Derived when omitted (BE VAT → 0208, else 0088).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'title': 'Jithox Fleet Trust Contract V1 — lookup_peppol_participant', 'required': ['schemaVersion', 'product', 'capability', 'decision', 'decisionCategory', 'data', 'provenance', 'limitations', 'receipt', 'billing', 'retryable', 'generatedAt'], 'properties': {'data': {'type': 'object'}, 'billing': {'type': 'object', 'required': ['billable', 'category'], 'properties': {'billable': {'type': 'boolean'}, 'category': {'enum': ['billable', 'non_billable'], 'type': 'string'}}, 'additionalProperties': False}, 'product': {'const': 'com.jithox/einvoice-readiness'}, 'receipt': {'oneOf': [{'type': 'null'}, {'type': 'object', 'required': ['receiptId', 'keyId', 'signature', 'publicKeyUrl'], 'properties': {'keyId': {'type': 'string'}, 'receiptId': {'type': 'string'}, 'signature': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}}, 'additionalProperties': False}]}, 'decision': {'enum': ['ready', 'not_ready', 'needs_review', 'unavailable'], 'type': 'string'}, 'retryable': {'type': 'boolean'}, 'capability': {'const': 'lookup_peppol_participant'}, 'provenance': {'type': 'object', 'required': ['source', 'date', 'checksum', 'freshness'], 'properties': {'date': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'checksum': {'type': ['string', 'null']}, 'freshness': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'generatedAt': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'schemaVersion': {'const': 'jithox.fleet-trust-contract/v1'}, 'receiptEnvelope': {'type': 'object', 'required': ['receiptVersion', 'canonicalizationVersion', 'algorithm', 'keyId', 'payload', 'signature', 'publicKeyUrl', 'verificationUrl'], 'properties': {'keyId': {'type': 'string'}, 'payload': {'type': 'object'}, 'algorithm': {'type': 'string'}, 'signature': {'type': 'string'}, 'resultHash': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}, 'receiptVersion': {'type': 'string'}, 'verificationUrl': {'type': 'string'}, 'canonicalizationVersion': {'type': 'string'}}, 'additionalProperties': False}, 'decisionCategory': {'enum': ['proceed', 'review', 'blocked', 'no_result', 'invalid_input', 'unavailable', 'stale'], 'type': 'string'}}, 'additionalProperties': False}
validate_invoice
Validate an EU invoice (structure)
Structurally validate a draft EU invoice and report machine-readable issues (schema problems, VAT-id format, date sanity, BIS 3.0 completeness, computed totals). Full report, never fails fast. Not legal approval. Validation and readiness only; never sends a Peppol invoice and gives no legal, fiscal or compliance guarantee.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['invoice'], 'properties': {'invoice': {'type': 'object', 'description': 'The invoice payload to check.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'title': 'Jithox Fleet Trust Contract V1 — validate_invoice', 'required': ['schemaVersion', 'product', 'capability', 'decision', 'decisionCategory', 'data', 'provenance', 'limitations', 'receipt', 'billing', 'retryable', 'generatedAt'], 'properties': {'data': {'type': 'object'}, 'billing': {'type': 'object', 'required': ['billable', 'category'], 'properties': {'billable': {'type': 'boolean'}, 'category': {'enum': ['billable', 'non_billable'], 'type': 'string'}}, 'additionalProperties': False}, 'product': {'const': 'com.jithox/einvoice-readiness'}, 'receipt': {'oneOf': [{'type': 'null'}, {'type': 'object', 'required': ['receiptId', 'keyId', 'signature', 'publicKeyUrl'], 'properties': {'keyId': {'type': 'string'}, 'receiptId': {'type': 'string'}, 'signature': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}}, 'additionalProperties': False}]}, 'decision': {'enum': ['ready', 'not_ready', 'needs_review', 'unavailable'], 'type': 'string'}, 'retryable': {'type': 'boolean'}, 'capability': {'const': 'validate_invoice'}, 'provenance': {'type': 'object', 'required': ['source', 'date', 'checksum', 'freshness'], 'properties': {'date': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'checksum': {'type': ['string', 'null']}, 'freshness': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'generatedAt': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'schemaVersion': {'const': 'jithox.fleet-trust-contract/v1'}, 'receiptEnvelope': {'type': 'object', 'required': ['receiptVersion', 'canonicalizationVersion', 'algorithm', 'keyId', 'payload', 'signature', 'publicKeyUrl', 'verificationUrl'], 'properties': {'keyId': {'type': 'string'}, 'payload': {'type': 'object'}, 'algorithm': {'type': 'string'}, 'signature': {'type': 'string'}, 'resultHash': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}, 'receiptVersion': {'type': 'string'}, 'verificationUrl': {'type': 'string'}, 'canonicalizationVersion': {'type': 'string'}}, 'additionalProperties': False}, 'decisionCategory': {'enum': ['proceed', 'review', 'blocked', 'no_result', 'invalid_input', 'unavailable', 'stale'], 'type': 'string'}}, 'additionalProperties': False}
validate_vat_number
Validate a VAT number (format)
Deterministic structure/checksum validation of an EU VAT number (incl. the Belgian modulo-97 checksum) with the normalized identifier and a stable issue code. Format plausibility only — not a live VIES result. Validation and readiness only; never sends a Peppol invoice and gives no legal, fiscal or compliance guarantee.
Nur Lesen
Eingabeschema
{'type': 'object', 'required': ['vatNumber'], 'properties': {'vatNumber': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': 'A VAT number, e.g. "BE0123456749".'}, 'countryCode': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO alpha-2, used only when the VAT has no prefix.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'title': 'Jithox Fleet Trust Contract V1 — validate_vat_number', 'required': ['schemaVersion', 'product', 'capability', 'decision', 'decisionCategory', 'data', 'provenance', 'limitations', 'receipt', 'billing', 'retryable', 'generatedAt'], 'properties': {'data': {'type': 'object'}, 'billing': {'type': 'object', 'required': ['billable', 'category'], 'properties': {'billable': {'type': 'boolean'}, 'category': {'enum': ['billable', 'non_billable'], 'type': 'string'}}, 'additionalProperties': False}, 'product': {'const': 'com.jithox/einvoice-readiness'}, 'receipt': {'oneOf': [{'type': 'null'}, {'type': 'object', 'required': ['receiptId', 'keyId', 'signature', 'publicKeyUrl'], 'properties': {'keyId': {'type': 'string'}, 'receiptId': {'type': 'string'}, 'signature': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}}, 'additionalProperties': False}]}, 'decision': {'enum': ['ready', 'not_ready', 'needs_review', 'unavailable'], 'type': 'string'}, 'retryable': {'type': 'boolean'}, 'capability': {'const': 'validate_vat_number'}, 'provenance': {'type': 'object', 'required': ['source', 'date', 'checksum', 'freshness'], 'properties': {'date': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'checksum': {'type': ['string', 'null']}, 'freshness': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'generatedAt': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'schemaVersion': {'const': 'jithox.fleet-trust-contract/v1'}, 'receiptEnvelope': {'type': 'object', 'required': ['receiptVersion', 'canonicalizationVersion', 'algorithm', 'keyId', 'payload', 'signature', 'publicKeyUrl', 'verificationUrl'], 'properties': {'keyId': {'type': 'string'}, 'payload': {'type': 'object'}, 'algorithm': {'type': 'string'}, 'signature': {'type': 'string'}, 'resultHash': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}, 'receiptVersion': {'type': 'string'}, 'verificationUrl': {'type': 'string'}, 'canonicalizationVersion': {'type': 'string'}}, 'additionalProperties': False}, 'decisionCategory': {'enum': ['proceed', 'review', 'blocked', 'no_result', 'invalid_input', 'unavailable', 'stale'], 'type': 'string'}}, 'additionalProperties': False}
verify_vat_vies
Verify a VAT number in VIES (live)
Check a VAT number's ACTIVE status against the official EU VIES source. Returns valid / invalid / invalid_input / unavailable with provenance (source, checkedAt). When VIES is unavailable it says so truthfully and makes no validity claim. Validation and readiness only; never sends a Peppol invoice and gives no legal, fiscal or compliance guarantee.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['vatNumber'], 'properties': {'vatNumber': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': 'A VAT number, e.g. "BE0123456749".'}, 'countryCode': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO alpha-2, used only when the VAT has no prefix.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'title': 'Jithox Fleet Trust Contract V1 — verify_vat_vies', 'required': ['schemaVersion', 'product', 'capability', 'decision', 'decisionCategory', 'data', 'provenance', 'limitations', 'receipt', 'billing', 'retryable', 'generatedAt'], 'properties': {'data': {'type': 'object'}, 'billing': {'type': 'object', 'required': ['billable', 'category'], 'properties': {'billable': {'type': 'boolean'}, 'category': {'enum': ['billable', 'non_billable'], 'type': 'string'}}, 'additionalProperties': False}, 'product': {'const': 'com.jithox/einvoice-readiness'}, 'receipt': {'oneOf': [{'type': 'null'}, {'type': 'object', 'required': ['receiptId', 'keyId', 'signature', 'publicKeyUrl'], 'properties': {'keyId': {'type': 'string'}, 'receiptId': {'type': 'string'}, 'signature': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}}, 'additionalProperties': False}]}, 'decision': {'enum': ['ready', 'not_ready', 'needs_review', 'unavailable'], 'type': 'string'}, 'retryable': {'type': 'boolean'}, 'capability': {'const': 'verify_vat_vies'}, 'provenance': {'type': 'object', 'required': ['source', 'date', 'checksum', 'freshness'], 'properties': {'date': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'checksum': {'type': ['string', 'null']}, 'freshness': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'generatedAt': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'schemaVersion': {'const': 'jithox.fleet-trust-contract/v1'}, 'receiptEnvelope': {'type': 'object', 'required': ['receiptVersion', 'canonicalizationVersion', 'algorithm', 'keyId', 'payload', 'signature', 'publicKeyUrl', 'verificationUrl'], 'properties': {'keyId': {'type': 'string'}, 'payload': {'type': 'object'}, 'algorithm': {'type': 'string'}, 'signature': {'type': 'string'}, 'resultHash': {'type': 'string'}, 'publicKeyUrl': {'type': 'string'}, 'receiptVersion': {'type': 'string'}, 'verificationUrl': {'type': 'string'}, 'canonicalizationVersion': {'type': 'string'}}, 'additionalProperties': False}, 'decisionCategory': {'enum': ['proceed', 'review', 'blocked', 'no_result', 'invalid_input', 'unavailable', 'stale'], 'type': 'string'}}, 'additionalProperties': False}
Hinzugefügt
get_einvoice_readiness
17. September 2026 12:35
Hinzugefügt
lookup_peppol_participant
17. September 2026 12:35
Hinzugefügt
verify_vat_vies
17. September 2026 12:35
Hinzugefügt
validate_vat_number
17. September 2026 12:35
Hinzugefügt
validate_invoice
17. September 2026 12:35