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

MCP Servers