Quickstart
From nothing to a verified tool call with a signed receipt. No card, no application, no approval — 25 free accepted calls over 14 days, shared across every available product.
Free to start
1Create an account and a credential
Sign up, verify your e-mail, then create an MCP credential from your dashboard. The credential is shown once — copy it immediately. If you lose it, rotate it; you never have to pay twice and your balance is untouched by a rotation.
2Point your MCP client at the endpoint
Each product is its own MCP server with its own OAuth resource, so a token minted for one is refused by another. That is deliberate: a credential cannot spend somewhere you did not intend.
E-Invoice https://mcp.jithox.com/mcp Import https://import.mcp.jithox.com/mcp Energy https://energy.mcp.jithox.com/mcp
Authentication is OAuth 2.1 with PKCE (S256, mandatory). Your client discovers the authorization server from /.well-known/oauth-protected-resource and registers itself — you paste your access key once on the consent screen, and the client keeps a refreshing connection.
3Initialize and list the tools
Every server answers the standard MCP handshake. Listing tools is free and needs no credit.
POST /mcp
{"jsonrpc":"2.0","id":1,"method":"initialize",
"params":{"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"my-agent","version":"1"}}}
POST /mcp
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}4Make your first call
A structural VAT check is the fastest way to see the whole path work — decision, evidence and a signed receipt.
POST /mcp
{"jsonrpc":"2.0","id":3,"method":"tools/call",
"params":{"name":"validate_vat_number",
"arguments":{"vatNumber":"BE0403170701"}}}The result carries a machine-readable decision state, the evidence behind it, and a _meta.receiptyou can verify offline against the server’s published public key.
5Know what a call costs before you make it
Prices are server-side and per accepted call. Your client never sends an amount, and nothing a client says can change a price.
| Product | Price per accepted call | Tools |
|---|---|---|
| einvoice | €0,10 | 5 |
| eu-import-preflight | €0,25 | 5 |
| eu-energy-label-preflight | €0,25 | 5 |
EU Counterparty Sanctions Preflight is temporarily unavailable: the official EU structured distribution is returning an upstream error, and we will not serve an out-of-date list as a current screening. Nothing is charged while it is unavailable.
6When the free calls run out
The server answers 402 payment_required with a typed body: the product, the tool, the price, your balance and the shortfall. It does not execute, does not charge, and does not upgrade you to anything. Add prepaid credit and repeat the same call.
- One balance covers every product — spend it wherever you like.
- Credit does not expire and there is no automatic top-up.
- Tax is charged on top of credit and is never spendable.
- A refund reverses credit; it never creates a negative balance.
Troubleshooting
| You see | What it means |
|---|---|
| 401 | No valid token. Re-run the OAuth flow; your client should do this for you. |
| 403 | The token is valid but not for this resource or scope — check you are calling the product you authorized. |
| 402 payment_required | Free calls used up and the balance cannot cover this call. Add credit and retry the same request. |
| 429 rate_limited | Too many calls too quickly. Honour the retry-after header; nothing was charged. |
| 503 canary_disabled | The operator paused this server. Nothing was executed and nothing was charged. |
| unavailable / source_unavailable | An upstream official source did not answer. You get a truthful non-answer, never a guess, and it costs €0,00. |
| Credential rejected after rotation | The old credential is contained on purpose. Use the new one; your balance and free calls are unchanged. |
Something not covered here? Support — include the correlation id from the error body and we can trace the exact call.
These figures are read from the running price catalog at request time, so this page cannot promise a price the server does not charge.