European Business Data MCP (SIREN / TVA / IBAN)

Validate EU businesses in one MCP: French company lookup (SIREN/SIRET), EU VAT verification (VIES), and IBAN validation for KYB and supplier onboarding workflows.

Features

• lookup_fr_company: Search French businesses (SIREN/SIRET/name) via API Recherche Entreprises.
• validate_eu_vat: Validate EU VAT numbers via official VIES SOAP service.
• validate_iban: Validate IBAN and return bank metadata via OpenIBAN.
• Retries with exponential backoff for transient upstream errors.
• In-memory rate limiting per upstream service.
• Structured JSON errors (VALIDATION_ERROR, UPSTREAM_ERROR, RATE_LIMITED, NOT_FOUND, INTERNAL_ERROR).

Ideal Use Cases

• Supplier onboarding pre-checks
• Invoice/VAT consistency checks
• Payout and beneficiary banking verification
• CRM/ERP enrichment for EU entities

Quick Start

npm install
npm run build
npm start

For local development:

$npm run dev

Tool Request Examples

1) French business lookup

{
  "name": "lookup_fr_company",
  "arguments": {
    "query": "SNCF",
    "perPage": 3
  }
}

2) EU VAT validation (VIES)

{
  "name": "validate_eu_vat",
  "arguments": {
    "countryCode": "FR",
    "vatNumber": "40303265045"
  }
}

3) IBAN validation

{
  "name": "validate_iban",
  "arguments": {
    "iban": "FR1420041010050500013M02606"
  }
}

Configuration

Optional environment variables:

• SIRENE_RATE_LIMIT_PER_MIN (default 60)
• VIES_RATE_LIMIT_PER_MIN (default 30)
• OPENIBAN_RATE_LIMIT_PER_MIN (default 60)

Testing

$npm test

Pricing (Launch)

• Free: 200 calls/month
• Starter: EUR 9/month (2,000 calls)
• Pro: EUR 29/month (20,000 calls)
• Business: EUR 99/month (high volume)

First-Run Verification

1. Run lookup_fr_company with a known French company.
2. Run validate_eu_vat with a valid VAT number.
3. Run validate_iban with a known valid IBAN.
4. Confirm JSON response contract in your MCP client.

Deployment Notes

Apify (primary channel)

• Package this server as an Apify Actor.
• Expose stdin/stdout MCP transport through the Actor runtime wrapper.
• Suggested first pricing for launch:
  • Free: 200 calls/month
  • Starter: EUR 9/month (2,000 calls)
  • Pro: EUR 29/month (20,000 calls)
  • Business: EUR 99/month (high-volume)

Smithery (secondary channel)

• Publish MCP metadata + tool docs.
• Keep the same free/starter/pro tiers for consistency.
• Positioning: B2B supplier onboarding, KYB pre-checks, payout verification workflows.

Limitations (v1)

• VIES uptime can vary by member state service availability.
• No persistent cache in v1 (stateless process model).
• Rate limiter is in-memory (per process) and should be replaced by shared storage at higher scale.