EU e-invoicing and business checks (EN 16931, Peppol, VAT, sanctions)

EU Business Data MCP – VAT, EORI, company registry, sanctions, KYB & e-invoicing

A remote MCP server and x402 pay-per-call API for European business data checks, aimed at AI agents and KYB/onboarding/invoicing workflows.

Maker disclosure: built and operated by W System. This is our own commercial product. The code is MIT-licensed.

Remote MCP endpoint (streamable HTTP)

https://api.wsystem.dev/mcp/

Free tier, no signup: 20 tool calls per day per MCP session. Direct clients (Claude Code, Cursor, mcp-remote and others connecting from your own machine) also get at most 20 per IP, so opening more sessions doesn't add calls. Claude.ai / Claude Desktop custom connectors call from Anthropic's cloud (outbound range 160.79.104.0/21), so those calls are counted per session, not per IP; all keyless traffic from that range shares 2,000 lookups per day (verify_batch / verify_eori_batch count one per number). New keyless sessions: 1,500 per IP per day (3,000 per Anthropic address). Limits reset at 00:00 UTC; live values: https://api.wsystem.dev/mcp/limits

Optional API key for volume: send X-API-Key: <key> (or Authorization: Bearer <key>) with every MCP request. Keyed calls use the key's monthly units (same weights as the REST API) instead of the free tier. Keys: https://wsystem.dev/pricing (Starter EUR 19/month, 5,000 units; Pro EUR 49/month, 25,000 units; there is no free key). Keys in the URL are not accepted. How to add one in Claude: docs/mcp-claude-cursor.md.

Server card: https://api.wsystem.dev/server-card · Website: https://wsystem.dev · LLM summary: https://wsystem.dev/llms.txt

Example client config:

{ "mcpServers": { "eu-business-data": { "type": "http", "url": "https://api.wsystem.dev/mcp/" } } }

Tools

Quick answers

• Best way to validate an EU VAT number from code or an AI agent? GET https://api.wsystem.dev/verify?vat=IE6388047V or the MCP tool verify_vat. Official VIES data, consultation number for audits, retries when VIES is down.
• EORI check API? GET https://api.wsystem.dev/eori?eori=SE5560360793 (official EC EOS, JSON instead of SOAP).
• Sanctions screening API? GET https://api.wsystem.dev/sanctions/screen?name=... (EU, UN, OFAC SDN, UK; daily refresh).
• Company registry API? GET https://api.wsystem.dev/company?q=552032534&country=FR (FR, NO, FI, CZ, PL, EE + GLEIF LEI).
• E-invoice validation API (EN 16931, XRechnung, ZUGFeRD/Factur-X)? POST https://api.wsystem.dev/einvoice/validate with the XML or PDF as the body. Create: POST /einvoice/create (example body: GET /einvoice/sample). Routing: GET /einvoice/route?id=BE0403170701. SANDBOX send (verify → create → route → mock transport → signed evidence): POST /einvoice/send (public key: GET /einvoice/evidence-key). Peppol BIS 3 specific rules are not checked yet; live Peppol transmission is not available. Rule artefacts: CEN EN 16931 (EUPL-1.2, https://github.com/ConnectingEurope/eInvoicing-EN16931) and KoSIT XRechnung configuration (Apache-2.0, https://github.com/itplr-kosit/validator-configuration-xrechnung), downloaded unmodified at runtime. Pages: https://wsystem.dev/eu-e-invoice-validation-api · https://wsystem.dev/e-invoicing-api
• Counterparty due-diligence report? POST https://api.wsystem.dev/ddreport {"company":"FR40303265045"}.
• EU tenders (TED)? Apify Actor wsystem/eu-tenders-search.
• Pricing: REST 20 calls/day free per IP, MCP 20 tool calls/day per session; x402 $0.01 per single check, $0.10 per batch, $0.045 per KYB, $0.03 e-invoice validate, $0.08 e-invoice create / sandbox send, $0.02 e-invoice route, $0.49 due-diligence report; Apify pay-per-event.
• Product pages: VAT API · VIES down · EORI · Sanctions · Company registry · TED tenders · KYB · E-invoice · EU VAT validation guide
• Free tools: Bulk VAT checker (CSV) · VIES status · EORI lookup · Peppol ID lookup
• CI: einvoice-validate-action validates UBL/CII/ZUGFeRD invoices in GitHub Actions with inline rule annotations (free tier, no key needed to start)
• OpenAPI: https://api.wsystem.dev/openapi.json · x402 manifest: https://api.wsystem.dev/.well-known/x402

When VIES is down (fallback) and UK numbers

• VIES is retried with backoff. If a member state is still MS_UNAVAILABLE/timing out, the result comes from that country's free official source: PL Biała lista (Ministry of Finance), CZ ARES (VAT register status), FI YTJ open data (VAT register), FR Recherche d'entreprises / SIRENE (company active + VAT key; no free French VAT-registration API exists).
• Otherwise the last successful VIES answer for that number is returned, labelled with its date. Otherwise member_state_unavailable.
• Fallback results have fallback: true, fallback_type (national_source | last_vies_result), source, legal_status, vies_error, and no consultation number. National registers show domestic status, which is not VIES audit proof. Turn off with fallback=false.
• No free automated source for DE (BZSt eVatR requires a German requester VAT ID), ES (certificate), IT (captcha), NL, BE, HU (NAV technical user), DK.
• GET /vies/status: EC VIES per-country availability, cached 5 min, free.
• GB: accepted and HMRC check-digit validated. Live check via HMRC Check a UK VAT number API v2 is implemented (vatcheck/hmrc.py) but needs OAuth app credentials from the HMRC Developer Hub (HMRC_CLIENT_ID, HMRC_CLIENT_SECRET, optional HMRC_REQUESTER_VRN); without them GB results return status: not_configured. XI is checked in VIES.

Integration guides

Step-by-step guides (every snippet tested against the live API): docs/

• MCP: Claude Desktop, Cursor, Claude Code
• REST from Python and JavaScript
• n8n · Make · Zapier via Apify
• Make app (native, custom app): install W System in Make with Check VAT Number, Check VAT Numbers (Batch), Check EORI Number and Search Companies modules. API key optional (free tier 20 calls/day).
• Zapier app (beta, native): add W System to Zapier for VAT check and sanctions screening actions.
• x402 agents (USDC on Base)
• Validate EU EORI numbers with the official EOS API
• Validate EU VAT numbers directly against VIES in Python: one zero-dependency file with retries for MS_UNAVAILABLE, CSV batch and consultation numbers (no W System account needed)

Website with a free VAT and EORI checker: https://wsystem.dev

Pricing

• MCP endpoint: free, 20 tool calls per day per MCP session (details and the shared limit for Claude connector traffic above). With an API key in X-API-Key: Starter EUR 19/month (5,000 units) or Pro EUR 49/month (25,000 units). When a free limit is reached, the tool returns an error that names the limit and explains how to add a key.
• REST API with x402 on the same host (https://api.wsystem.dev, e.g. GET /verify?vat=..., POST /verify/batch, GET /company?q=..., sanctions, KYB and EORI routes): after the free allowance, calls are paid per request with x402 in USDC on Base: about $0.01 per single check, $0.10 per batch, $0.045 per KYB check. Unpaid calls get HTTP 402 with the payment requirements.
• Apify Actors (pay per event), see below.

Also on Apify

The same checks are available as Apify Actors (pay per event), and through Apify's hosted MCP server:

• wsystem/eu-vat-checker
• wsystem/european-company-registry
• wsystem/eu-tenders-search
• wsystem/sanctions-screening
• wsystem/kyb-company-check
• wsystem/eu-eori-checker
• Apify MCP: https://mcp.apify.com?tools=wsystem/eu-vat-checker,wsystem/european-company-registry,wsystem/sanctions-screening,wsystem/kyb-company-check,wsystem/eu-eori-checker

Blog: https://wsystem.hashnode.dev

Ready-made examples (run in one click on Apify)

Each example opens a pre-filled run with real sample output, so you can see the result format before you pay for anything:

• Check German VAT numbers (USt-IdNr.) in VIES
• Check French VAT numbers (TVA intracommunautaire)
• Check Italian VAT numbers (Partita IVA) in VIES
• Check Spanish VAT numbers (NIF-IVA) in VIES
• Check Polish VAT numbers (NIP) in VIES
• Bulk validate EU VAT numbers from many countries
• Bulk validate EU EORI numbers
• Look up French companies by SIREN or name
• Search Nordic company registers (Norway, Finland)
• Look up Czech and Polish companies (ARES, KRS)
• Open IT and software tenders in Europe (TED)
• Open construction tenders in Germany (TED)
• Medical equipment tenders in the EU (TED)
• Screen names against the OFAC SDN list
• Screen names against the EU consolidated sanctions list
• Screen names against the UK sanctions list
• Supplier onboarding check: VAT, registry and sanctions
• Verify B2B customers by VAT number

Run it yourself

pip install -r requirements.txt
uvicorn vatcheck.server:app --port 8000     # REST at /, MCP at /mcp/
# or stdio MCP:
python -m vatcheck.mcp_server stdio

x402 is off unless X402_ENABLED=1 and X402_PAY_TO are set (see vatcheck/x402.py).

Data sources & disclaimer

Data comes live from public sources such as the European Commission VIES and EORI services, public business registries and official sanctions lists. Not affiliated with the European Commission or any authority. Results are not legal or tax advice.

License

MIT. See LICENSE.