@czagents/eu-registry

European business registry lookups in one MCP — verify companies across 16 EU/EEA countries via official national registries and GLEIF/LEI + VIES. Full national data for 9 countries; partial Lithuania JAR data; identity + ownership baseline for 6 other countries. Entity status, registration data, addresses, parent-company resolution, and EU VAT validation. Built for cross-border due-diligence and KYC directly in your AI assistant.

Part of the cz-agents suite.

Supported registries

Full national data (entity, status, address, registration date):

| Country | Source | Notes | |---------|--------|-------| | GB | Companies House | Requires free CH_API_KEY from developer.company-information.service.gov.uk | | SK | ORSR / RPO | No auth required | | PL | KRS | No auth required | | FR | SIRENE | No auth required | | NO | Brønnøysund (BRREG) | No auth required | | DK | CVR (Erhvervsstyrelsen) | Optional DK_CVR_USER/DK_CVR_PASS (free, request at [email protected]); public fallback otherwise | | FI | PRH YTJ Open Data v3 | Free, no API key, CC BY 4.0 | | EE | RIK open data dump | Daily bulk ingest to local SQLite via EE_RIK_DB_PATH; no API key, CC BY 4.0 | | SE | Bolagsverket HVD API | Free OAuth credentials from Bolagsverket; exact organisation-number lookup. Name search uses GLEIF/LEI because HVD has no name-search endpoint. |

Partial national-registry data: Lithuania

| Country | Source | Notes | |---------|--------|-------| | LT | Registrų centras JAR open data | Monthly local SQLite ingest via LT_JAR_DB_PATH; CC BY 4.0. Name, code and registration date are served from JAR. The official legal-status classifier label is exposed as status_label; application status remains unknown and normalized_status null. Addresses and officers are not published or enriched; JADIS and other enrichment are out of scope. VIES/GLEIF remains the fallback if the local store is unavailable or has no matching record. |

Identity + ownership baseline (name, address, status, VAT validity, GLEIF/LEI parent-company resolution — no officer/board data; for registries that are paywalled):

| Country | Source | Notes | |---------|--------|-------| | DE | GLEIF/LEI + VIES | No auth required | | NL | GLEIF/LEI + VIES | No auth required | | IT | GLEIF/LEI + VIES | No auth required | | AT | GLEIF/LEI + VIES | No auth required | | ES | GLEIF/LEI + VIES | VIES returns validity only for ES (no name/address) | | BE | GLEIF/LEI + VIES | No auth required |

Tools

Each example is an MCP tool-call argument object.

• search_company — searches supported non-Czech registries by full or partial company name. Do not use it when you already have an exact national ID, or expect full national-registry data for GLEIF-only countries. Example: {"name":"Tesco","country":"GB","limit":5}.
• get_company — fetches a supported non-Czech company by its national ID and country. Do not use it for Czech companies, or with a name instead of the country-specific identifier. Example: {"id":"14356670","country":"GB"}.
• lookup_company_by_vat — validates an EU VAT number through VIES and returns disclosed registration details. Do not use it to obtain director/board data, or assume name/address are available for every member state. Example: {"vat":"NL123456789B01"}.

Configuration

| Variable | Required | Description | |----------|----------|-------------| | CH_API_KEY | No | UK Companies House API key. Without it GB adapter returns empty results. | | GLEIF_CACHE_PATH | No | Path to SQLite cache file for GLEIF responses (DE/NL/IT/AT/ES/BE/LT). Falls back to in-memory if unset. | | GLEIF_CACHE_TTL_DAYS | No | Cache TTL in days. Default: 7. | | DK_CVR_USER / DK_CVR_PASS | No | Denmark CVR data credentials (free, request at [email protected]). Without them the DK adapter uses its public fallback. | | EE_RIK_DB_PATH | No | Path to SQLite store for Estonia RIK bulk data. Default: ./ee-rik.db. | | LT_JAR_DB_PATH | No | Path to SQLite store for Lithuania Registrų centras JAR open data. Default: ./lt-jar.db. | | SE_BOLAGSVERKET_CLIENT_ID / SE_BOLAGSVERKET_CLIENT_SECRET | No | Sweden Bolagsverket HVD OAuth credentials. Without them exact SE lookups return no result; name search still uses GLEIF. | | PORT | No | HTTP transport port. Default: 3036. |

Usage

npx (stdio transport)

{
  "mcpServers": {
    "eu-registry": { "command": "npx", "args": ["-y", "@czagents/eu-registry"] }
  }
}

Hosted endpoint (no install)

{
  "mcpServers": {
    "eu-registry": { "url": "https://eu-registry.cz-agents.dev/mcp" }
  }
}

Related packages

• @czagents/ares — Czech ARES business registry
• @czagents/dd — Czech due-diligence aggregator (includes get_eu_parent and get_eu_dd_report on Compliance tier)
• @czagents/sanctions — EU FSF + OFAC sanctions screening

Development

npm run build
npm test
npm run start:http

Estonia bulk ingest:

EE_RIK_DB_PATH=/absolute/path/ee-rik.db npm run build --workspace=@czagents/eu-registry
EE_RIK_DB_PATH=/absolute/path/ee-rik.db npm run ingest:ee-rik --workspace=@czagents/eu-registry

Lithuania JAR bulk ingest (run monthly):

LT_JAR_DB_PATH=/absolute/path/lt-jar.db npm run build --workspace=@czagents/eu-registry
LT_JAR_DB_PATH=/absolute/path/lt-jar.db npm run ingest:lt-jar --workspace=@czagents/eu-registry

LT results expose the upstream Last-Modified value as source_snapshot_at when available, separately expose ingested_at, and carry the CC BY 4.0 attribution. The official JAR open-data endpoint reported zero non-null values for both pilnas_adresas and adresas; the implementation therefore always returns no address and marks address not published in open data. It does not fetch JADIS, officers, or GLEIF-derived addresses.