# ORSF — Slovak Company Register (npm · @orsf/mcp-server)

1.25M+ Slovak companies, aggregated from 8 registers (RPO/ORSR/RÚZ/ZRSR/RPVS/CRZ/ÚVO/FS DPH).

- Trust score: 60/100 (medium)
- Change this week: +21
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@orsf/mcp-server`: 60/100 (this document), [markdown](https://verifymcp.io/servers/sk-orsf-mcp-server/orsf-mcp-server.md), [page](https://verifymcp.io/servers/sk-orsf-mcp-server/orsf-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@orsf/mcp-server`
- Version: `0.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 9 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 74/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1050 tokens (~150/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add sk-orsf-mcp-server -- npx -y @orsf/mcp-server
```

### Codex

```bash
codex mcp add sk-orsf-mcp-server -- npx -y @orsf/mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sk-orsf-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@orsf/mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sk-orsf-mcp-server --command npx --arg -y --arg @orsf/mcp-server
```

### Hermes

```yaml
mcp_servers:
  sk-orsf-mcp-server:
    command: "npx"
    args: ["-y", "@orsf/mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "sk-orsf-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@orsf/mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 60, +41)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional] Licence: MIT

### 2026-08-01 (score 19, +5)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass

### 2026-07-31 (score 14, +14)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 0, −39)

- [security regression] Malware scan: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 39)

First indexed and scored.

## MCP tools (7)

### `search_companies` (~344 tokens)

Search the ORSF register of Slovak companies (~800k records). Full-text search over company name, IČO (company ID) and DIČ (tax ID), with structured filters. Returns a paginated list with basic company info. Use this first when the user mentions a company by name — get the IČO, then call get_company for full details.

Input parameters:

- `establishedYearMax` (integer): Only companies established on or before this year.
- `establishedYearMin` (integer): Only companies established on or after this year.
- `isVatPayer` (boolean): Filter by VAT payer status (true = registered DPH platiteľ).
- `legalForm` (string): Filter by legal form code (e.g. "112" = s.r.o., "121" = a.s., "701" = združenie). Omit for all.
- `limit` (integer): Max results to return (default 20, max 100).
- `offset` (integer): Pagination offset (default 0).
- `q` (string): Free-text query — company name, IČO (8 digits) or DIČ (10 digits).
- `region` (string): Filter by region (kraj) — e.g. "Bratislavský kraj", "Košický kraj". Case-insensitive partial match.
- `register` (string): Filter by source register: "ORSR" (Obchodný register) or "ZRSR" (Živnostenský register).
- `status` (string): Filter by company status: "active" (existing) or "dissolved" (zaniknutá).

### `lookup_company` (~178 tokens)

Fast IČO autofill lookup — the right tool for forms, invoices, and KYB/KYC identity checks. Returns: legal name, legal form, status, established/dissolved dates, full postal address, DIČ (tax ID), IČ DPH (VAT ID) + isVatPayer flag, NACE code, and source register lineage — aggregated live from 8 Slovak registers (RPO, ORSR, RÚZ, ZRSR, RPVS, CRZ, ÚVO, FS DPH), not a single-register proxy. Redis-cached, typically <50ms. Use `get_company` instead when you also need directors/officers or multi-year financial statements.

Input parameters:

- `ico` (string, required): Company IČO — 6 to 8 digits (e.g. "55609830").

### `get_company` (~123 tokens)

Fetch the full profile of a single company by IČO (8-digit Slovak company ID). Returns: legal name, legal form, status, address, statutory bodies (people with roles), business activities, and up to 10 most recent financial filings (revenue, assets, equity, net income). Data is cached from source registers (RÚZ, RPO, ORSR, FS DPH) with lazy-refresh if stale.

Input parameters:

- `ico` (string, required): Company IČO — 6 to 8 digits (e.g. "55609830").

### `refresh_company` (~127 tokens)

Force-refresh a company from upstream source registers. Useful when the caller suspects stale data, or after a recent change in ORSR. Respects a per-IČO 60 s cooldown. Returns the refreshed company record. Default sources: ruz, rpo, orsr.

Input parameters:

- `ico` (string, required): Company IČO — 6 to 8 digits.
- `sources` (string): Comma-separated list of sources to refresh. Allowed: ruz, rpo, orsr, fs-dph. Example: "ruz,rpo". Default: "ruz,rpo,orsr".

### `get_company_graph` (~119 tokens)

Return the ownership / statutory graph around a company — people and other companies connected through roles (statutory body, executive, proprietor, shareholder). Depth 1 = direct connections only; depth 2 = also second-degree connections (people of connected companies). Use to answer questions like "who controls X" or "what other firms does the CEO of X run".

Input parameters:

- `depth` (integer): Graph traversal depth (1 or 2). Default 1.
- `ico` (string, required): Company IČO — 6 to 8 digits.

### `get_person` (~80 tokens)

Fetch a single person record by internal ORSF person ID (UUID / ULID). Returns the person's identifying fields plus all roles they currently hold across companies. Use the IDs from get_company (roles[].personId) or get_company_graph to obtain a person ID.

Input parameters:

- `id` (string, required): Internal person ID — returned by get_company / get_company_graph.

### `get_person_graph` (~79 tokens)

Return the graph around a person — all companies where they hold a role, and optionally (depth=2) other people connected through those companies. Use to map a person's full portfolio of Slovak companies.

Input parameters:

- `depth` (integer): Graph traversal depth (1 or 2). Default 1.
- `id` (string, required): Internal person ID.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/sk-orsf-mcp-server/orsf-mcp-server#diagnostics

## Score history

- 2026-08-03: 60
- 2026-08-02: 60
- 2026-08-01: 19
- 2026-07-31: 14
- 2026-07-30: 0
- 2026-07-28: 39
- 2026-07-27: 39

## Links

- npm package: https://www.npmjs.com/package/@orsf/mcp-server
- Socket report: https://socket.dev/npm/package/@orsf/mcp-server
- Website: https://orsf.sk/api
- Changelog RSS feed: https://verifymcp.io/servers/sk-orsf-mcp-server/orsf-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/sk-orsf-mcp-server/orsf-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/sk-orsf-mcp-server/orsf-mcp-server