使用说明

finstat-mcp

MCP server, ktory sprístupňuje finstat.sk API ako nástroje pre Claude.

Umožňuje vyhľadávať slovenské firmy podľa názvu alebo IČO a získavať ich finančné údaje priamo v Claude Desktop.

Prerekvizity

Inštalácia

uv sync

Konfigurácia

Skopírujte .env.example do .env:

cp .env.example .env

Doplňte svoje API kľúče z finstat.sk:

FINSTAT_API_KEY=váš_api_kľúč
FINSTAT_PRIVATE_KEY=váš_privátny_kľúč

Použitie

Claude Desktop

Automatická inštalácia:

uv run mcp install src/finstat_mcp/server.py:mcp -f .env --name finstat

Alternatívne môžete manuálne upraviť konfiguračný súbor:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "finstat": {
      "command": "uv",
      "args": ["run", "--directory", "/ABSOLUTNA/CESTA/finstat_MCP", "finstat-mcp"],
      "env": {
        "FINSTAT_API_KEY": "váš_api_kľúč",
        "FINSTAT_PRIVATE_KEY": "váš_privátny_kľúč"
      }
    }
  }
}

Claude Code (CLI / VS Code extension)

claude mcp add --transport stdio --scope user \
  --env FINSTAT_API_KEY=váš_api_kľúč \
  --env FINSTAT_PRIVATE_KEY=váš_privátny_kľúč \
  finstat -- uv run --directory /ABSOLUTNA/CESTA/finstat_MCP finstat-mcp

Cursor

Pridajte konfiguráciu do jedného z týchto súborov:

Globálny: ~/.cursor/mcp.json
Projektový: .cursor/mcp.json

{
  "mcpServers": {
    "finstat": {
      "command": "uv",
      "args": ["run", "--directory", "/ABSOLUTNA/CESTA/finstat_MCP", "finstat-mcp"],
      "env": {
        "FINSTAT_API_KEY": "váš_api_kľúč",
        "FINSTAT_PRIVATE_KEY": "váš_privátny_kľúč"
      }
    }
  }
}

Windsurf

Upravte konfiguračný súbor ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "finstat": {
      "command": "uv",
      "args": ["run", "--directory", "/ABSOLUTNA/CESTA/finstat_MCP", "finstat-mcp"],
      "env": {
        "FINSTAT_API_KEY": "váš_api_kľúč",
        "FINSTAT_PRIVATE_KEY": "váš_privátny_kľúč"
      }
    }
  }
}

Iné klienty (VS Code, JetBrains, …)

Štandardný mcpServers JSON formát (rovnaký ako vyššie) funguje vo väčšine MCP-kompatibilných klientov. Konkrétne umiestnenie konfigurácie nájdete v dokumentácii daného klienta.

Vývoj

Spustenie MCP Inspector:

uv run mcp dev src/finstat_mcp/server.py:mcp

Nástroje

Základné informácie o firmách

Nástroj	Popis
`finstat_detail`	Základné údaje o firme podľa IČO (názov, adresa, právna forma, stav)
`finstat_basic`	Základné údaje o firme pre fakturačné účely (Invoice API)
`finstat_autocomplete`	Vyhľadávanie firiem podľa názvu (min. 3 znaky)
`finstat_extended`	Rozšírené údaje vrátane finančných ukazovateľov (tržby, zisk)
`finstat_ultimate`	Najkompletnejšie údaje vrátane vlastníckej štruktúry

Účtovné výkazy

Nástroj	Popis
`finstat_get_statements`	Zoznam účtovných výkazov firmy
`finstat_get_statement_detail`	Detail konkrétneho účtovného výkazu (IČO, rok, šablóna)
`finstat_get_statement_template_legend`	Legenda k šablóne výkazu

Monitoring

Nástroj	Popis
`finstat_add_to_monitoring`	Pridanie firmy do monitoringu
`finstat_remove_from_monitoring`	Odobratie firmy z monitoringu
`finstat_monitoring_list`	Zoznam monitorovaných firiem
`finstat_monitoring_report`	Report zmien monitorovaných firiem
`finstat_monitoring_proceedings`	Dôležité udalosti (konania) monitorovaných firiem

Konkurzy a reštrukturalizácie

Nástroj	Popis
`finstat_company_bankruptcy_restructuring`	Vyhľadávanie konkurzov a reštrukturalizácií podľa IČO alebo názvu

Exekúcie (spoplatnené)

Nástroj	Popis
`finstat_request_distraint_search`	Vyhľadávanie exekúcií
`finstat_request_distraint_detail`	Detail exekúcie podľa tokenu a ID
`finstat_request_distraint_stored_detail`	Uložený detail exekúcie
`finstat_request_distraint_results`	Výsledky vyhľadávania exekúcií
`finstat_request_distraint_results_by_token`	Výsledky exekúcií podľa tokenu

Inteligentný reporting

Nástroj	Popis
`finstat_get_reporting_topics`	Dostupné témy reportov
`finstat_get_reporting_list`	Zoznam reportov pre danú tému
`finstat_get_reporting_output`	Stiahnutie reportu (xlsx, vrátený ako base64)

API dokumentácia

Podrobnosti o FinStat API nájdete na finstat.sk.

Licencia

MIT