Merk MCP Server

This is a TypeScript implementation of a Model Context Protocol (MCP) server that interacts with the Merk.cz API for retrieving business registry data for Czech and Slovak companies.

Features

The server provides tools for:

• Looking up company information by registration number
• Finding company relations (connected companies and persons)
• Searching for companies by name

Setup

1. Ensure you have Node.js 18+ installed
2. Install dependencies:

npm install

3. Create a .env file in the project root with your Merk API key:

MERK_API_KEY=your_api_key_here

Building the Server

To build the server:

npm run build

Running the Server

To run the server directly:

node build/index.js

For development and testing, you can use the MCP Inspector tool:

npm run inspector

Available Tools

company_lookup

Looks up detailed company information by its registration number.

Parameters:

• regno: Company registration number (required)
• country_code: Country code - "cz" or "sk" (default: "cz")

company_relations

Gets a list of related persons or companies and their relationship types.

Parameters:

• regno: Company registration number (required)
• country_code: Country code - "cz" or "sk" (default: "cz")
• relation_type: Type of relations to return - "current", "any", or "historical" (default: "current")

company_name_lookup

Looks up companies by name or part of a name.

Parameters:

• name: Company name or part of it (required)
• country_code: Country code - "cz" or "sk" (default: "cz")

API Documentation

For more information about the Merk API, see the API documentation in the docs folder.

License

MIT