mcp-invoicenow-sg 🇸🇬
Scaffold stage — not yet published. This repository contains the package skeleton only. No tools, models, or validators are implemented yet, and no release has been tagged. See Current status for what is blocking implementation.
Introduction
mcp-invoicenow-sg is an MCP (Model Context Protocol) server
that will expose tools for Singapore electronic invoicing over InvoiceNow, the national
e-invoicing platform operated by IMDA. It is part of the mcp-einvoicing-* family of
country-specific servers, all built on
mcp-einvoicing-core, which provides the
shared validation engine, EN 16931 abstractions, and Peppol network utilities.
Current status
The package is a scaffold. Implementation is gated on normative source material that has not been supplied yet.
| Area | Status |
|---|---|
| Repository, CI, governance docs | Done |
Package skeleton (src/ layout, server entry point) |
Done |
Normative specifications under specs/ |
Missing |
| Supported standards and profile URNs | Blocked |
| Invoice model and validators | Blocked |
| MCP tools | Blocked |
First release (v0.1.0) |
Blocked |
Compliance values for this package are never written from memory. They are read from
normative documents placed in specs/ and recorded in the monorepo country
reference before any code uses them. The document list and what each one unblocks is in
specs/sources.md.
Supported standards
[NEED: confirm from the PINT-SG specification]
Singapore uses the Peppol network through InvoiceNow rather than a clearance model. The
specific profile version, CustomizationID and ProfileID URNs, the EN 16931 conformance
relationship, and the applicable Schematron rule set are all unresolved until the PINT-SG
specification is supplied. This section is filled in from that document, not from memory.
Installation
Requirements
- Python ≥ 3.11
mcp-einvoicing-core(installed automatically as a dependency)
Using uvx (recommended, once published)
uvx mcp-invoicenow-sg
Using uv
uv add mcp-invoicenow-sg
From source
git clone https://github.com/cmendezs/mcp-invoicenow-sg.git
cd mcp-invoicenow-sg
uv sync --all-extras
Configuration
Add the server to your MCP client configuration:
{
"mcpServers": {
"invoicenow-sg": {
"command": "uvx",
"args": ["mcp-invoicenow-sg"]
}
}
}
Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
LOG_LEVEL |
No | INFO |
Logging level: DEBUG, INFO, WARNING, or ERROR |
Country-specific variables (transport endpoints, credentials, environment switches) are added
once the specification documents them. See .env.example.
Tools
None yet. The server starts and registers zero tools at this stage.
The tool reference in docs/TOOLS.md is generated from the running server:
uv run python scripts/gen_tool_reference.py
Contributing
See CONTRIBUTING.md for development setup, the test and lint commands, and the pull request checklist. Security issues follow the private disclosure process in SECURITY.md.
Other e-invoicing MCP servers
| Country | Server |
|---|---|
| 🌍 Global | mcp-einvoicing-core |
| 🇧🇪 Belgium | mcp-einvoicing-be |
| 🇧🇷 Brazil | mcp-nfe-br |
| 🇫🇷 France | mcp-facture-electronique-fr |
| 🇩🇪 Germany | mcp-einvoicing-de |
| 🇮🇹 Italy | mcp-fattura-elettronica-it |
| 🇵🇱 Poland | mcp-ksef-pl |
| 🇸🇬 Singapore | mcp-invoicenow-sg |
| 🇪🇸 Spain | mcp-facturacion-electronica-es |
| 🇦🇪 United Arab Emirates | mcp-einvoicing-ae |
License
This project is licensed under the Apache 2.0 license — see LICENSE for details.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_invoicenow_sg-0.1.0.tar.gz.
File metadata
- Download URL: mcp_invoicenow_sg-0.1.0.tar.gz
- Upload date:
- Size: 8.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dc2441a1a40d23a0e532ad54d332397fa199b20d413a7e3db1edb12e75c24707
|
|
| MD5 |
c9a1383c055f5e01dc55ebce54b76075
|
|
| BLAKE2b-256 |
7e159b0d53b86e7043dc20830e33b334fed755d03ea525dd82dda0d37a72cebf
|
Provenance
The following attestation bundles were made for mcp_invoicenow_sg-0.1.0.tar.gz:
Publisher:
publish.yml on cmendezs/mcp-invoicenow-sg
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_invoicenow_sg-0.1.0.tar.gz -
Subject digest:
dc2441a1a40d23a0e532ad54d332397fa199b20d413a7e3db1edb12e75c24707 - Sigstore transparency entry: 2623988619
- Sigstore integration time:
-
Permalink:
cmendezs/mcp-invoicenow-sg@a390bd574ead8dde21cba0b9baa2d8a99993df5e -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/cmendezs
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a390bd574ead8dde21cba0b9baa2d8a99993df5e -
Trigger Event:
push
-
Statement type:
File details
Details for the file mcp_invoicenow_sg-0.1.0-py3-none-any.whl.
File metadata
- Download URL: mcp_invoicenow_sg-0.1.0-py3-none-any.whl
- Upload date:
- Size: 70.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5d198f66dd74b42b39576d4d4f8659d7140007db5add3c051a4cbb92ce548b7c
|
|
| MD5 |
aba1b9d539f27daefcdf3b5832761c51
|
|
| BLAKE2b-256 |
62fc1f6c1348c977c7ac44666fec11ad94754d73a2edf9d3526b0cf4c13b306f
|
Provenance
The following attestation bundles were made for mcp_invoicenow_sg-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on cmendezs/mcp-invoicenow-sg
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_invoicenow_sg-0.1.0-py3-none-any.whl -
Subject digest:
5d198f66dd74b42b39576d4d4f8659d7140007db5add3c051a4cbb92ce548b7c - Sigstore transparency entry: 2623988688
- Sigstore integration time:
-
Permalink:
cmendezs/mcp-invoicenow-sg@a390bd574ead8dde21cba0b9baa2d8a99993df5e -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/cmendezs
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a390bd574ead8dde21cba0b9baa2d8a99993df5e -
Trigger Event:
push
-
Statement type:
