# aria-mcp-cvr-dk

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that looks up Danish companies in CVR (Det Centrale Virksomhedsregister) via [cvrapi.dk](https://cvrapi.dk). Built for [ARIA](https://github.com/kimhjort/aria) and shareable with the community.

Use-case: ARIA resolves a company from an invoice, email, or contract — *"hvem er CVR 12345678"* or *"find firmaet Netcompany"*.

## Data Source & Attribution

| Source | What | Attribution |
|--------|------|-------------|
| [cvrapi.dk](https://cvrapi.dk) | Danish company data from CVR (Det Centrale Virksomhedsregister) | cvrapi.dk / CVR (Erhvervsstyrelsen). Free tier: ~50 lookups/day. |

**Important:** A descriptive `User-Agent` header is required by cvrapi.dk's terms of service. This server sets it automatically:

```
aria-mcp-cvr-dk/1.0.0 (https://github.com/kimhjort/aria-mcp-cvr-dk)
```

The free tier allows approximately **50 requests per day**. For higher volume, see [cvrapi.dk](https://cvrapi.dk) for commercial options.

## Install & Run

```bash
npx aria-mcp-cvr-dk
```

Or install globally:

```bash
npm install -g aria-mcp-cvr-dk
aria-mcp-cvr-dk
```

Requires Node.js 20 or later.

## Tools

### `lookup_company({ query })`

Look up a Danish company by **CVR number**, **company name**, or **phone number**.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | **Yes** | Company name, CVR number (8 digits), or phone number. |

**Returns (found):**

```json
{
  "found": true,
  "query": "Novo Nordisk",
  "company": {
    "cvr": "24256790",
    "name": "NOVO NORDISK A/S",
    "address": "Novo Alle 1",
    "zipcode": "2880",
    "city": "Bagsværd",
    "phone": "44448888",
    "email": null,
    "industry_code": 212000,
    "industry_description": "Fremstilling af farmaceutiske præparater",
    "company_type_code": 60,
    "company_type": "Aktieselskab",
    "active": true,
    "start_date": "28/11 - 1931",
    "end_date": null,
    "employees": 30074,
    "credit_bankrupt": false
  }
}
```

**Returns (not found):**

```json
{
  "found": false,
  "query": "nonexistent company",
  "message": "No company found for query \"nonexistent company\" in CVR. Try an exact CVR number (8 digits) or a different spelling."
}
```

---

### `search_companies({ name })`

Search for Danish companies by name.

**Note:** cvrapi.dk returns a **single best match** per query, not a paginated list of results. This tool returns that one match and documents this behaviour explicitly. For an exact lookup by CVR number, use `lookup_company` instead.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `name` | string | **Yes** | Company name or partial name to search for. |

**Returns:**

```json
{
  "found": true,
  "query": "Netcompany",
  "note": "cvrapi.dk returns a single best match per query, not a paginated list. This is that best match.",
  "match_count": 1,
  "companies": [{ "cvr": "...", "name": "...", "..." : "..." }]
}
```

## Company Result Fields

| Field | Type | Description |
|-------|------|-------------|
| `cvr` | string | CVR number (8 digits) |
| `name` | string | Legal company name |
| `address` | string \| null | Street address |
| `zipcode` | string \| null | Postal code |
| `city` | string \| null | City |
| `phone` | string \| null | Phone number |
| `email` | string \| null | Email address |
| `industry_code` | number \| null | Danish industry code (DB07) |
| `industry_description` | string \| null | Danish industry description |
| `company_type_code` | number \| null | CVR company type code |
| `company_type` | string \| null | Company type (e.g. "Aktieselskab", "Anpartsselskab") |
| `active` | boolean | `true` if the company has no end date (still active) |
| `start_date` | string \| null | Registration start date |
| `end_date` | string \| null | Registration end date (null = still active) |
| `employees` | number \| null | Number of employees (if available) |
| `credit_bankrupt` | boolean \| null | Whether the company is bankrupt |

## ARIA MCP Config

Add to your ARIA credentials / MCP config to use with ARIA:

```json
{
  "Name": "CVR",
  "Command": "npx",
  "Args": ["-y", "aria-mcp-cvr-dk"]
}
```

No environment variables required — cvrapi.dk is keyless.

## Development

```bash
git clone https://github.com/kimhjort/aria-mcp-cvr-dk
cd aria-mcp-cvr-dk
npm install
npm run build
npm test
```

## License

MIT — see [LICENSE](LICENSE).

Company data is sourced from CVR (Det Centrale Virksomhedsregister) via [cvrapi.dk](https://cvrapi.dk). Please respect cvrapi.dk's [terms of service](https://cvrapi.dk) and the ~50 requests/day free-tier limit.