ShepDogSk/susrrpo-mcp

3.1

If you are the rightful owner of susrrpo-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The SUSRRPO MCP Server provides access to the Slovak Register of Legal Entities, Entrepreneurs, and Public Authority Bodies API, enabling efficient entity search and retrieval.

Tools

6

Resources

0

Prompts

0

SUSRRPO MCP Server

Model Context Protocol (MCP) server for accessing the Slovak Register of Legal Entities, Entrepreneurs and Public Authority Bodies (SUSRRPO) API.

Features

Search entities by various criteria (name, ICO, DIC, type)
Get entity details by ID, ICO, or DIC
List available entity types
Build search URLs for direct API access
Comprehensive error handling and timeout management
TypeScript support with full type definitions

Installation

npm install susrrpo-mcp

Usage

As MCP Server

Add to your MCP client configuration:

{
  "susrrpo": {
    "command": "susrrpo-mcp",
    "args": []
  }
}

Available Tools

`search_entities`

Search for entities in the SUSRRPO register.

Parameters:

query (optional): General search query
ico (optional): Organization identification number
dic (optional): Tax identification number
name (optional): Entity name
type (optional): Entity type
limit (optional): Maximum results (1-100, default: 20)
offset (optional): Results to skip (default: 0)

`get_entity_by_id`

Get entity details by ID.

Parameters:

id (required): Entity ID

`get_entity_by_ico`

Get entity details by ICO.

Parameters:

ico (required): Organization identification number

`get_entity_by_dic`

Get entity details by DIC.

Parameters:

dic (required): Tax identification number

`get_entity_types`

Get list of available entity types.

Parameters: None

`build_search_url`

Build URL for entity search.

Parameters:

Same as search_entities

API Endpoints

The server connects to the SUSRRPO API at https://api.statistics.sk/rpo/v1/.

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

License

MIT

Author

Michal Gašparík