Virkly MCP Server

Model Context Protocol server for accessing Danish company data in AI assistants.

This MCP server enables AI assistants like Claude Desktop, Cursor IDE, and other MCP-compatible clients to look up and search Danish companies using the Virkly API.

Features

• CVR Lookup - Get detailed company information by CVR number (with full ERST data via expand)
• CVR Search - Search for companies by name with pagination
• CVR Persons - List all persons with roles at a company (directors, board, owners, founders)
• Person Lookup - Look up a person by enhedsNummer, with roles and professional network
• Person Search - Search for persons by name with pagination
• Industry List - Browse Danish industries with company counts
• Real-time Data - Access up-to-date company data from Danish Business Authority (ERST)
• Structured Responses - Clean JSON output for easy AI processing
• API Key Authentication - Simple and secure authentication

Installation

npm install -g @virkly/mcp-server

Or locally:

npm install @virkly/mcp-server

Prerequisites

You need a Virkly API key to use this MCP server.

1. Sign up at virkly.io
2. Create an API key in your dashboard

Setup

Claude Desktop

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "virkly": {
      "command": "npx",
      "args": ["-y", "@virkly/mcp-server"],
      "env": {
        "VIRKLY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor IDE

Add this to your Cursor MCP settings (Settings > Features > MCP Servers):

{
  "virkly": {
    "command": "npx",
    "args": ["-y", "@virkly/mcp-server"],
    "env": {
      "VIRKLY_API_KEY": "your_api_key_here"
    }
  }
}

Environment Variables

• VIRKLY_API_KEY (required) - Your Virkly API key
• VIRKLY_BASE_URL (optional) - Custom API endpoint (default: https://virkly.io)

Usage

Once configured, you can use the MCP tools in your AI assistant:

CVR Lookup

Look up a company by CVR number:

Look up company with CVR 36070867

Parameters:

• cvr (string, required) - CVR number (8 digits)
• expand (boolean, optional) - Return full ERST data instead of curated format (default: false)

Example response:

Company: A.P. Moller - Maersk A/S
CVR: 36070867
Status: Aktiv
Address: Esplanaden 50, 1098 Kobenhavn K, Denmark
Industry: Shipping
Start Date: 1996-01-01

CVR Search

Search for companies by name with pagination:

Find companies named "Maersk" — page 2

Parameters:

• query (string, required) - Company name or partial name (min 2 characters)
• limit (number, optional) - Maximum results per page (default: 10, max: 50)
• page (number, optional) - Page number (default: 1)

CVR Persons

List all persons associated with a company:

Who are the directors and owners of CVR 36070867?

Parameters:

• cvr (string, required) - CVR number (8 digits)

Returns: Name, role, enhedsNummer, start date, and ownership percentage for each person.

Person Lookup

Look up person with enhedsNummer 4000059964

Parameters:

• enhedsNummer (integer, required) - ERST enhedsNummer of the person
• include_historic (boolean, optional) - Include ended roles (default: false)

Returns: Name, statistics, active roles, and professional network (co-directors/board members).

Person Search

Find persons named "Jensen" — page 2

Parameters:

• name (string, required) - Person name or partial name (min 2 characters)
• limit (number, optional) - Maximum results per page (default: 10, max: 100)
• page (number, optional) - Page number (default: 1)

Troubleshooting

"VIRKLY_API_KEY environment variable is required"

Your API key is not configured. Make sure you've added it to your MCP server configuration.

"Invalid VIRKLY_API_KEY"

Your API key is incorrect or has been revoked. Check your API key at virkly.io/dashboard/keys.

"CVR number must be exactly 8 digits"

CVR numbers in Denmark are always 8 digits. Make sure you're providing the full CVR number without spaces or dashes.

Server not showing up in Claude Desktop

1. Restart Claude Desktop after updating the configuration
2. Check that the JSON configuration is valid
3. Verify that Node.js is installed and accessible
4. Check Claude Desktop logs for errors

Links

• Virkly Homepage
• API Documentation
• Dashboard
• Model Context Protocol

Support

• Email: [email protected]
• Documentation: virkly.io/docs