# Jithox VAT/VIES Verification

> Jithox VAT/VIES Verification is a paid API for AI agents from mcp.jithox.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Verifies a VAT number against the EU VIES system and returns a machine-readable decision envelope indicating whether the VAT registration is valid and the entity is ready to transact on e-invoices.

## Facts

- Endpoint: POST https://mcp.jithox.com/x402/mainnet/paycall/tools/verify_vat_vies?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jithox-vat-vies-verification-20bc842e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7Tb3BXM8NkYRxuGDdDlqZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability jithox-vat-vies-verification-20bc842e -d '<json body>'
```

Example prompt: Can you check whether VAT number DE123456789 is currently valid and active in VIES, and tell me if we can proceed to issue them an invoice without any manual review?

## When to prefer this

Choose this endpoint when you need a decision-grade, audit-ready VIES check with a machine-readable envelope — specifically when the result must include structured canProceed/blockingReasons logic and a signed provenance receipt suitable for automated AP or e-invoicing workflows. Prefer it over raw VIES scraping when you need downstream auditability, over generic VAT format validators when live registry status matters, and over manual lookups when integrating into agentic or no-touch invoice pipelines.

## Known failure modes

- VIES service temporarily unavailable — returns upstream error with provenance noting the outage
- Malformed or structurally invalid VAT number format — returns invalid state with blocking reason
- VAT number not found in VIES (unregistered or deregistered entity) — returns invalid state
- Rate limit or payment failure for per-call billing — request rejected before processing
- EU member state VIES endpoint timeout — may return inconclusive state with requiresHumanReview flag

## How this service works

Decision-grade VAT, VIES, Peppol and invoice readiness for AI agents: five read-only MCP tools that return one machine-readable decision with a signed receipt. Public self-service: free trial, then pay per accepted call.

## Output

A JSON object containing a 'state' field (e.g. 'valid' or 'invalid'), a structured 'decision' envelope with canProceed boolean, warnings list, blockingReasons list, nextActions list, and a requiresHumanReview flag, plus a 'provenance' block showing the data source (VIES) and the timestamp of the check. A cryptographically signed receipt is also returned for audit purposes.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "state": "invalid",
  "decision": {
   "status": "ready",
   "summary": "Example decision envelope — see the decision field of a real response.",
   "decision": {
    "warnings": [],
    "canProceed": true,
    "nextActions": [],
    "blockingReasons": [],
    "requiresHumanReview": false
   }
  },
  "provenance": {
   "source": "vies",
   "checkedAt": "2026-07-01T00:00:00Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jithox-vat-vies-verification-20bc842e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.jithox.com](https://www.zero.xyz/host/mcp.jithox.com/llms.txt)