com.jithoxPublished by jithox.comOfficial publisherv1.1.0Updated Oct 24, 2026
8 invoice/payment tools; 5 free, no login. IBAN, bank changes, Peppol. Paid VAT and invoice review.
The publisher's own server: Jithox Commerce Preflight
Remote MCP server for pre-payment and e-invoice checks: IBAN structure, supplier bank changes, Peppol readiness and EU VAT lookups, with signed evidence.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.jithox%2Fjithox/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"jithox": {
"type": "http",
"url": "https://jithox.com/api/mcp"
}
}
}Jithox runs a remote MCP server. Its front
door is preflight_payment: one free call, before an agent pays an invoice,
that answers stop, review_required or no_blockers_found with signed
evidence. Next to it are read-only checks for e-invoices and payments: IBAN
structure, supplier bank-detail changes, Peppol BIS Billing 3.0 rule
validation, Peppol participant (receiver) lookup, and VIES lookup.
It is for developers and AI agents that prepare an e-invoice or a payment and want a check before something is sent, submitted to Peppol, or paid.
This repository holds examples, a registry manifest and one agent plugin package. It contains no server code. The server itself is hosted by Jithox.
See PACKAGE.md for the portable Agent Plugins package and its Claude Code, Cursor, Gemini and Grok configuration. Validation scope and primary sources are in docs/PLUGIN_VALIDATION.md. No public directory listing or recommendation is implied.
After the reviewed package reaches the public default branch, Claude Code can discover this repository marketplace with:
For Agent-Skills-compatible clients:
The v1.0.0 discovery-only check DISABLE_TELEMETRY=1 npx skills add . --list
listed one skill on 2026-10-02. The GEBRUIK1 candidate contains five skills;
that file inventory is not an installation or completed agent task. The remote command installs from the published repo;
review its permissions and selected version before accepting.
Build the upload ZIP deterministically from the repository root:
The builder includes only its explicit runtime-file allowlist. ZIP uploads, publisher verification and directory applications remain owner actions.
Gebruik gewone vragen voor skillselectie; activatie verschilt per client en is
nog geen bewezen taak. Expliciet: Claude /jithox:<commandnaam> (pluginnamespace),
Gemini /<commandnaam> (bij naamconflict kan de extensionnamespace verschijnen).
De bestanden staan in commands/*.md en commands/*.toml; alle vijf skills
hebben precies twee scenario's in hun eigen references/examples.md.
Zie GEBRUIK1-validatie en het
reproduceerbare evalpakket. Eigen probes zijn geen
extern gebruik. Deze kandidaat is niet gepubliceerd of als beter geëvalueerd.
preflight_paymentCall preflight_payment once, before your agent pays an invoice. It compares
what the person approved, as your agent reports it (payee, amount, currency,
account), with what is about to be paid; checks the IBAN and a changed
supplier bank account against the one on file; and answers stop,
review_required or no_blockers_found, with every check, what it does not
prove, and a signed evidence token. No account, no token. It never pays and
never calls an account safe: a check that did not run is listed as not_run,
never as a pass.
The 2026-09-25 measurement covered only invoice_bank; the other rails then
returned review_required with rail_not_covered. This is historical evidence,
not current coverage: read the live schema and every returned check for the
actual invoice_bank, x402, card_or_giftcard or crypto_bridge proposal.
The person approved paying invoice 2026-105 to Acme BV; the invoice now asks for a different account than the one on file. The payment instruction is copied from that invoice, so instructionSource is ingested_content, while approved separately records what the person approved. These are fictional sample inputs:
The corrected request above was measured anonymously on 2026-10-03 with
x-jithox-probe: gebruik1-fix: HTTP 200, review_required, instruction: warn,
reasons instruction_not_from_human and payment_change_verify_first, and
charged: false. Missing invoice/VAT checks remained not_run. No payment
was made; the human approval did not change the invoice instruction's source.
Historical output from the old, incorrectly human-labelled request, measured on
2026-09-25; not the response to the corrected request above. The unwrapped
result is retained unchanged; … marks where it was shortened for this page:
Anyone can check that a verdict was not changed: POST the jws (optionally
with the input and its inputSalt) to
https://jithox.com/api/v1/evidence/verify. The untouched token answered
"status": "valid"; the same token with its verdict changed answered
"invalid" with reason signature_mismatch (tested 2026-09-25).
Transport: Streamable HTTP (POST, JSON-RPC 2.0).
No account or token is needed for tools/list.
Open Settings → Developer → Edit Config, and add the block above to
claude_desktop_config.json (macOS:
~/Library/Application Support/Claude/claude_desktop_config.json; Windows:
%APPDATA%\Claude\claude_desktop_config.json). Restart Claude Desktop.
Use tools/list on this endpoint as the source for current availability:
tool names, descriptions and input schemas. Read that live response rather
than relying on a fixed tool count or catalog in this README.
Limits: 30 requests per minute per IP on this endpoint; above that you get
HTTP 429 with Retry-After.
Output is shown as returned; … marks where it was shortened for this page.
The tool result (result.content[0].text), unwrapped:
Change issueDate to "23/09/2026" or drop buyerReference and the same
call returns "verdict": "will_be_rejected" with the specific rule that
failed (e.g. PEPPOL-EN16931-F001, PEPPOL-EN16931-R003) — checked
2026-09-22.
This asks the live Peppol directory about a THIRD PARTY. It is never a promise the invoice will arrive, be accepted or be paid — every answer says so.
examples/python/preflight_payment.py —
standard library only: initialize, then preflight_payment on a payment
whose supplier bank account changed, then POST /api/v1/evidence/verify on
the signed answer. Run with python examples/python/preflight_payment.py.
Historical output from the old Python example (instructionSource=human),
measured on 2026-09-25; not output from the corrected script:
examples/python/peppol_ready.py —
standard library only: initialize, then check_peppol_ready on a
compliant invoice, then lookup_peppol_participant on the buyer. Run with
python examples/python/peppol_ready.py. Real output against production,
2026-09-23:
examples/python/free_tools.py — standard
library only: initialize, tools/list, then verify_iban.examples/csharp/Program.cs — .NET Framework 4.x,
no packages: initialize, then the free check_payment_change with fictitious
Belgian accounts. Prints the server, verdict, reason, human steps and
doesNotProve from the response (charged only when supplied). HTTP timeout:
15 seconds; HTTP, JSON-RPC, tool errors and missing/invalid result fields exit
nonzero. From examples/csharp, compile with
csc /nologo /r:System.Net.Http.dll /r:System.Runtime.Serialization.dll Program.cs,
run offline checks with Program.exe --self-test, then the live example with
Program.exe. Exit 0 means a valid response, not permission to pay.examples/dogfood/ — our own
dogfood example (in Dutch): the paid check_vat_list on the VAT number of an invoice we received.skills/pay-invoices-safely/SKILL.md
is an Agent Skill for an agent that
is about to pay a supplier invoice or change a supplier's bank account. It
teaches the agent to call check_payment_change on every new IBAN and to hold
the payment for a call-back by a person, to compare approval and proposed
payment with preflight_payment, and to check the invoice with
check_peppol_ready. Required VAT/company checks use the existing tools only
with an authorized connection; missing access is reported as not_run.
A required unknown or not_run check prevents a ready report.
It is written for three triggers: every supplier bank change, every invoice IBAN that differs from the vendor record, and every payment run.
Set SKILLS_DIR to the skills directory that the documentation of your own
Agent-Skills-compatible client names. This repository does not know that path
for any client; do not guess it. Then run this in a POSIX shell (Git Bash on
Windows works), with git and Node 18+ installed. It pins the public repository
at commit 9193a770320aa144e66e8630c830be33858f21ad, the main head
measured on 2026-09-28; use a newer commit only after you have reviewed it.
If SKILLS_DIR is empty the flow stops with a non-zero status before anything
is fetched or copied. Otherwise it copies exactly skills/pay-invoices-safely
(SKILL.md and references/examples.md) to $SKILLS_DIR/pay-invoices-safely,
overwriting files of the same name there.
The last command checks the source copy, not your installed one: it verifies
the spec rules, runs each curl example against production (free, read-only
HTTP calls), requires every tool it calls to be in the live tools/list, and
rejects price-like text. The current checker makes one narrow exception for the
two exact VAT-skill cost lines when they also match live tools/list; it does not
allow arbitrary prices or money claims elsewhere. Commands mirror the skill
body and are pinned separately.
A clone, a copy and our own checker show that the files can be fetched and that the examples still run. They do not show that any agent loaded the skill, completed a task with it, or used it a second time.
server.json in this repository, following the official MCP
registry schema (2025-12-11). The server is also published in the
official MCP registry as com.jithox/jithox
(registry.modelcontextprotocol.io/v0/servers?search=com.jithox/jithox).Nothing on this endpoint sends an invoice, submits it to Peppol, posts, pays or delivers anything. Results are technical checks, not legal or tax advice.
The examples and package code/documentation are MIT-licensed (see LICENSE). Official schema snapshots retain their Apache-2.0 license in scripts/schemas/. Brand-asset provenance and rights are in assets/ORIGIN.md. The Jithox service itself is not open source.
Source: README.md at commit 4a87801
Look up an EU company
VAT status / does this company exist: look up one EU VAT or enterprise number in EU VIES (Belgian KBO/BCE included). Returns registered name, VAT id, address and status; not proof of every company without VAT registration. 2 credits (EUR 0.02) per successful call; needs a bearer token.
vatNumberrequiredcountryCodeReview an invoice
Check a structured invoice: Peppol fields, totals, EU VIES VAT, fixes and UBL XML. Never sends; unanswered VAT is unknown. No receiver lookup here. If the receiver has a Peppol address, next call check_peppol_ready with this invoice. 8 credits (EUR 0.08) per review the VAT register answered; needs a bearer token.
notelinesrequireddueDatepaymentcurrencycustomerrequiredsupplierrequiredtotalVatissueDaterequiredtotalWithVatinvoiceNumberrequiredbuyerReference+2 moreCheck an IBAN
Check an IBAN's structure and check digits for 70+ countries, offline. It never claims the account exists or who owns it. Free, no token.
ibanrequiredexpectedCountryCheck Peppol invoice readiness
Check your own invoice against 21 published Peppol BIS Billing 3.0 rules, and whether the customer's Peppol address is registered; each finding names the rule and the fix. A listed subset, not the official validator. Free, no token.
linescurrencycustomersuppliertotalVatissueDatetotalWithVatinvoiceNumberbuyerReferenceorderReferencedocumentChargestotalWithoutVat+1 moreLook up a Peppol receiver
Ask live Peppol registers about e-invoice reception, document types and failure contacts; never guarantees delivery. Not a VAT or company-register check; use kbo_company_search (one company) or check_vat_list (a list). Free, no token.
schemeidentifierrequiredCheck a supplier bank change
Check a supplier's bank-detail change before the vendor record is touched: returns no_change, verify_first, stop or invalid_new_account with call-back steps. It never says an account is safe. Free, no token.
newIbanrequiredibanOnFilesupplierCountryCheck before a payment
For a structured invoice, call review_invoice first. Before paying, compare the supplied human approval with the payment and run rail checks (invoice: IBAN, account change). Without approved: review_required or stop, never no_blockers_found. Returns checks and signed evidence. Never pays; unrun checks never pass. Free, no token.
railrequiredchecksinvoicemandatepaymentrequiredapprovedibanOnFileinstructionSourceCheck EU VAT numbers
Check up to 20 rows of EU VAT numbers in EU VIES, row for row; a malformed or non-EU row is judged locally (`not_covered`, never `invalid`). UNKNOWN COSTS NOTHING, and the balance must cover the whole call (20 credits for 20 rows) before it runs. Optional requesterVatId adds a consultation number registered to you; a requester VIES refuses costs nothing. 1 credit (EUR 0.01) per answered row; needs a bearer token.
rowsrequiredrequesterVatId100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
com.jithoxOfficial publisher
A read-only commerce and checkout preflight server that returns evidence about UCP/ACP flows without placing orders.
com.jithoxOfficial publisher
A remote, read-only MCP server that lets an assistant screen counterparty names and identifiers against a dated snapshot of the EU Consolidated Financial Sanit…
com.jithoxOfficial publisher
Read-only EU import preflight server that checks EORI numbers, suggests TARIC code candidates, lists import measures, estimates low-value landed cost and issues
com.jithoxOfficial publisher
Lets an assistant look up public EU EPREL energy-label records read-only and produce a verifiable preflight receipt.
com.jithoxOfficial publisher
A remote, read-only MCP server that lets an assistant check EU e-invoice readiness: VAT number format, VIES status, Peppol registration and draft invoice checks
Remote MCP URL: https://jithox.com/api/mcpClaude Code: claude mcp add --transport http jithox https://jithox.com/api/mcpCodex: codex mcp add jithox --url https://jithox.com/api/mcpCursor: cursor://anysphere.cursor-deeplink/mcp/install?name=jithox&config=eyJ1cmwiOiJodHRwczovL2ppdGhveC5jb20vYXBpL21jcCJ9VS Code: vscode:mcp/install?%7B%22name%22%3A%22jithox%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fjithox.com%2Fapi%2Fmcp%22%7DGemini CLI (~/.gemini/settings.json): {"mcpServers":{"jithox":{"httpUrl":"https://jithox.com/api/mcp"}}}/plugin marketplace add victor-emmanuel-c/jithox-mcp/plugin install jithox@jithoxnpx skills add victor-emmanuel-c/jithox-mcppython scripts/plugin_package.py ../directories/jithox-agent-plugin-1.0.0.zipcurl -s https://jithox.com/api/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preflight_payment","arguments":{"rail":"invoice_bank","approved":{"amount":"1210.00","currency":"EUR","payee":{"name":"Acme BV"},"purpose":"Invoice 2026-105"},"instructionSource":"ingested_content","payment":{"iban":"BE71 0961 2345 6769","amount":"1210.00","currency":"EUR","payeeName":"Acme BV","supplierCountry":"BE"},"ibanOnFile":"BE68539007547034"}}}'{ "kind": "payment_preflight", "data": { "schemaVersion": "jx.payment-preflight/v1", "verdict": "review_required", "reasons": [{ "code": "payment_change_verify_first", "check": "payment_change" }], "humanStep": "Call the supplier back on a phone number from your own records (never one from this invoice or its e-mail) and have them read the account number to you.", "checks": [ { "id": "approval", "status": "pass", … }, { "id": "iban", "status": "pass", "value": "BE71 **** **** 6769: structure and check digits are right", … }, { "id": "payment_change", "status": "warn", "value": "verify_first", "findings": ["bank_changed"], … }, { "id": "vat_register", "status": "not_run", "reason": "needs_connection", … }, … ], "billing": { "charged": false, "units": [] }, … }, "evidence": { "format": "compact-jws", "jws": "eyJhbG…", "jwks": "https://jithox.com/.well-known/jwks.json", "verify": "https://jithox.com/api/v1/evidence/verify", … }}https://jithox.com/api/mcp{ "mcpServers": { "jithox": { "url": "https://jithox.com/api/mcp" } }}curl -s https://jithox.com/api/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_peppol_ready","arguments":{"invoiceNumber":"INV-2026-0001","issueDate":"2026-09-23","currency":"EUR","buyerReference":"PO-4471","totalWithoutVat":1000,"totalVat":210,"totalWithVat":1210,"lines":[{"description":"Consulting hours","quantity":10,"unitPrice":100,"vatPercent":21}],"supplier":{"name":"Seller BV","countryCode":"BE","endpointId":"0403170701","endpointScheme":"0208"},"customer":{"name":"Buyer NV","countryCode":"BE","endpointId":"0400378485","endpointScheme":"0208"}}}}'{ "kind": "peppol_ready_check", "data": { "verdict": "ready", "failed": [], "passed": [ … 21 rules, e.g. BR-02, PEPPOL-EN16931-R010, PEPPOL-EN16931-R003 … ], "notChecked": [], "summary": "Nothing is wrong among the 21 rules this check covers.", "rulesChecked": 21, "doesNotProve": "This checks 21 of the published Peppol BIS Billing 3.0 rules … a clean result here means nothing among these rules is wrong, not that the network will accept the document." }}curl -s https://jithox.com/api/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"lookup_peppol_participant","arguments":{"identifier":"0403170701"}}}'{ "kind": "peppol_participant_lookup", "data": { "participantId": "0208:0403170701", "reachable": "yes", "documentTypes": [ { "profile": "Peppol BIS Billing 3.0", "document": "Invoice", "raw": "…" } … ] }}server: jithox-engineverdict: review_requiredreasons: ['payment_change_verify_first']checks: {'approval': 'pass', 'mandate': 'not_run', 'instruction': 'pass', 'iban': 'pass', 'supplier_country': 'pass', 'payment_change': 'warn', 'invoice_local': 'not_run', 'hidden_text': 'not_run', 'peppol_participant': 'not_run', 'supplier_memory': 'not_run', 'vat_register': 'not_run', 'sanctions': 'not_run'}humanStep: Call the supplier back on a phone number from your own records (never one from this invoice or its e-mail) and have them read the account number to you.charged: Falseevidence: valid inputMatch: Trueserver: jithox-engineverdict: ready - Nothing is wrong among the 21 rules this check covers.reachable: yes participant: 0208:0403170701SKILLS_DIR= # absolute path from your client's documentation: "${SKILLS_DIR:?set SKILLS_DIR before copying}" &&SRC=$(mktemp -d) &&git -C "$SRC" init -q &&git -C "$SRC" fetch -q --depth 1 https://github.com/victor-emmanuel-c/jithox-mcp.git 9193a770320aa144e66e8630c830be33858f21ad &&git -C "$SRC" checkout -q FETCH_HEAD &&mkdir -p "$SKILLS_DIR" &&cp -R "$SRC/skills/pay-invoices-safely" "$SKILLS_DIR/" &&(cd "$SRC" && node scripts/check-skill.mjs skills/pay-invoices-safely)