# @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](https://cz-agents.dev) 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 cvrselvbetjening@erst.dk); 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 cvrselvbetjening@erst.dk). 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)

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

### Hosted endpoint (no install)

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

## Related packages

- [`@czagents/ares`](https://www.npmjs.com/package/@czagents/ares) — Czech ARES business registry
- [`@czagents/dd`](https://www.npmjs.com/package/@czagents/dd) — Czech due-diligence aggregator (includes `get_eu_parent` and `get_eu_dd_report` on Compliance tier)
- [`@czagents/sanctions`](https://www.npmjs.com/package/@czagents/sanctions) — EU FSF + OFAC sanctions screening

## Development

```bash
npm run build
npm test
npm run start:http
```

Estonia bulk ingest:

```bash
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):

```bash
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.