@orsf/mcp-server

@orsf/mcp-server

MCP (Model Context Protocol) server for ORSF — Otvorený register slovenských firiem. Gives LLM agents tool-call access to ~800k Slovak company records via the public REST API at https://api.orsf.sk.

Tools

Tool	Purpose
search_companies	Full-text + filter search over the register
get_company	Full profile for one IČO (address, roles, activities, filings)
refresh_company	Force-refresh from upstream sources (RÚZ/RPO/ORSR/FS)
get_company_graph	People + other firms connected to a company (depth 1 or 2)
get_person	Person detail + all roles held
get_person_graph	Portfolio of companies a person is connected to

Install — Claude Code

claude mcp add orsf -- npx -y @orsf/mcp-server

Install — Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent path on Windows / Linux:

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

Config

Env var	Default	Meaning
ORSF_API_URL	https://api.orsf.sk	Override base URL (for self-hosted or staging).

License

MIT