ORSF MCP server for Slovak companies
@orsf/mcp-server is a Model Context Protocol server that gives AI agents (Claude, ChatGPT, Cursor, Zed, Continue, Windsurf) direct access to 1.25M+ Slovak companies and sole traders via tool-calls. One-line install. Free, open-source, MIT-licensed.
Install in 30 seconds
Claude Code
bash
claude mcp add orsf -- npx -y @orsf/mcp-serverClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
json
{
"mcpServers": {
"orsf": {
"command": "npx",
"args": ["-y", "@orsf/mcp-server"]
}
}
}Cursor / Continue / Windsurf / Zed
Use the same JSON config in your tool's MCP settings file.
What tools does the server expose?
| Tool | Description | Auth |
|---|---|---|
search_companies | Fulltext + filters (Meilisearch) | — |
get_company | Company detail by IČO | — |
get_company_graph | Connection graph company↔persons↔companies | ✅ |
get_person | Person detail + all roles | ✅ |
get_person_graph | Person-centric graph | ✅ |
get_stats | Aggregate counts | — |
refresh_company | Force-refresh from source | ✅ + rate-limit |
Example conversation
After install, in Claude (or any MCP client) you can ask:
Use orsf to find companies with "poisťovňa" in their name in Bratislava
Use orsf get_company 55609830
Show me the connection graph for 35757442
How many VAT payers are in district SK010?Security and privacy
- Server runs locally — never sends your prompts to any third party.
- Only calls the ORSF REST API at api.orsf.sk.
- Auth required only for person-level data (GDPR Art. 6(1)(f)).
- Open-source — full source on GitHub.