Developer Portal

Build on the Jithox Engine

Every block that powers Jithox agents — Peppol BIS 3.0 e-invoicing, EU VIES company verification, PDF invoices, payments, SMS/WhatsApp, Slack, Notion, Google Sheets — is exposed as a standard Model Context Protocol server. Point Claude Desktop, an IDE agent, or your own autonomous system at one endpoint and call compliance-grade business tools, metered per call in euro cents.

1 · Connect Claude Desktop

Add the Jithox server to your claude_desktop_config.json (Settings → Developer → Edit Config). Clients with native remote-MCP support connect directly:

{
  "mcpServers": {
    "jithox": {
      "type": "http",
      "url": "https://app.jithox.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
      }
    }
  }
}

Clients that only speak stdio can bridge through mcp-remote:

{
  "mcpServers": {
    "jithox": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://app.jithox.com/api/mcp",
        "--header", "Authorization: Bearer <YOUR_ACCESS_TOKEN>"
      ]
    }
  }
}

2 · Authenticate

Machine clients exchange OAuth 2.1 client_credentials for a short-lived signed access token — client_secret_basic and client_secret_post are both accepted (form-encoded or JSON):

curl -X POST https://app.jithox.com/api/oauth/token \
  -H "content-type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=<YOUR_CLIENT_ID>" \
  -d "client_secret=<YOUR_CLIENT_SECRET>"

• Discovery is open. tools/list needs no token — directories and agents can browse the catalog freely.
• Invocation fails closed. tools/call without a valid bearer returns a per-tool auth error; nothing executes, nothing is billed.
• Side effects need standing approval. Tools that send, pay, or write for real run behind a human consent gate — an agent cannot opt itself in.

3 · Call a tool

Standard MCP over Streamable HTTP. A free example — verify a company against the EU VIES register:

curl -X POST https://app.jithox.com/api/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "kbo_company_search",
      "arguments": { "vatNumber": "BE0403170701" }
    }
  }'

4 · Tool catalog

Generated from the live registry — what you see here is exactly what tools/list returns. Billing is prepaid Agent Credits (1 credit = €0.01), deducted once per successful execution and idempotent per run.