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: (or Authorization: Bearer ) 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 (14)

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.01 e-invoice parse, $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
• Client libraries: PHP / Laravel wsystem/wsystem-php (Composer, with an eu_vat validation rule) · JavaScript wsystem (npm) · n8n node n8n-nodes-wsystem · Postman collection
• 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, but the live HMRC lookup is not switched on yet (HMRC production access pending). GB numbers return status: member_state_unavailable, valid: null, error: HMRC_LIVE_ACCESS_PENDING: not a validity result, not cached and not billed. XI (Northern Ireland) 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 REST API docs and a free API key (no card): https://api.wsystem.dev/docs?ref=mcp-github

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](https://x402.org) 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](https://apify.c