Tvrtke MCP Server

Aktivno

Tvrtke MCP Server povezuje AI agente i razvojne alate s podacima iz Sudskog registra i Financijske agencije (FINA). Omogućuje pretraživanje trgovačkih društava, provjeru ovlaštenih osoba i stvarnih vlasnika, pregled povijesti pravnih promjena te analizu godišnjih financijskih izvještaja.

Službeni MCP endpoint

https://tvrtke.podaci.dev/mcp

Kako dodati poslužitelj u svoj alat

Odaberite svoje radno okruženje i slijedite brze korake ili kopirajte konfiguraciju.

Dodavanje kroz terminal:

Pokrenite naredbu u nastavku u svom terminalu
Provjerite status povezivanja pomoću naredbe claude mcp list
Pokrenite claude i postavite upit o bilo kojoj hrvatskoj tvrtki

CLI naredba:

claude mcp add --transport http tvrtke https://tvrtke.podaci.dev/mcp

Gdje kliknuti (Brzo dodavanje kroz sučelje):

Otvorite postavke Cursora (ikona zupčanika ⚙️ u gornjem desnom kutu ili Ctrl+,)
U izborniku s lijeve strane odaberite Features → MCP Servers
Kliknite gumb + Add New MCP Server
Unesite Name: tvrtke
Odaberite Type: sse (ili streamableHttp)
U Server URL zalijepite: https://tvrtke.podaci.dev/mcp
Kliknite Add — poslužitelj se odmah aktivira sa zelenom ikonom

Ili uredite konfiguracijsku datoteku:

Datoteka: .cursor/mcp.json

{
  "mcpServers": {
    "tvrtke": {
      "url": "https://tvrtke.podaci.dev/mcp"
    }
  }
}

Gdje kliknuti:

Otvorite paletu naredbi (Ctrl+Shift+P ili Cmd+Shift+P na Macu)
Odaberite MCP: Add Server... → HTTP (HTTP or Server-Sent Events)
Zalijepite URL: https://tvrtke.podaci.dev/mcp i unesite naziv tvrtke
Ili spremite JSON konfiguraciju u .vscode/mcp.json unutar projekta

Konfiguracijska datoteka:

Datoteka: .vscode/mcp.json

{
  "servers": {
    "tvrtke": {
      "type": "http",
      "url": "https://tvrtke.podaci.dev/mcp"
    }
  }
}

Gdje kliknuti:

U izborniku aplikacije otvorite Claude → Settings (ili File → Settings)
U lijevom izborniku odaberite Developer
Kliknite gumb Edit Config — otvorit će se datoteka claude_desktop_config.json
Zalijepite JSON konfiguraciju u nastavku i spremite datoteku
Ponovno pokrenite Claude Desktop (Restart)

Konfiguracijska datoteka:

Datoteka: claude_desktop_config.json

{
  "mcpServers": {
    "tvrtke": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://tvrtke.podaci.dev/mcp"
      ]
    }
  }
}

Gdje kliknuti:

Pritisnite Ctrl+, (Cmd+, na Macu) ili kliknite Zed → Settings → Open Settings
Pronađite blok context_servers (ili ga dodajte u postavke)
Dodajte poslužitelj tvrtke s konfiguracijom u nastavku
Spremite datoteku — u traci asistenta pojavit će se dostupni alati

Konfiguracijska datoteka:

Datoteka: ~/.config/zed/settings.json

{
  "context_servers": {
    "tvrtke": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://tvrtke.podaci.dev/mcp"
        ]
      }
    }
  }
}

Gdje kliknuti:

Otvorite Windsurf postavke (Settings → Cascade → MCP)
Kliknite gumb Add Server
Odaberite SSE/HTTP transport
Unesite Server Name: tvrtke i URL: https://tvrtke.podaci.dev/mcp
Potvrdite unos — Windsurf automatski preuzima popis alata

Konfiguracijska datoteka:

Datoteka: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tvrtke": {
      "serverUrl": "https://tvrtke.podaci.dev/mcp"
    }
  }
}

Upute za postavljanje:

Otvorite konfiguracijsku datoteku ~/.gemini/settings.json
Dodajte tvrtke unutar bloka mcpServers s URL-om https://tvrtke.podaci.dev/mcp
Ponovno pokrenite sesiju — svi alati bit će odmah dostupni agentu

Konfiguracijska datoteka:

Datoteka: ~/.gemini/settings.json

{
  "mcpServers": {
    "tvrtke": {
      "url": "https://tvrtke.podaci.dev/mcp"
    }
  }
}

Gdje kliknuti u web aplikacijama i prilagođenim agentima:

U postavkama vašeg agenta ili sučelja kliknite Add Custom Connector ili Add Action
Kao naziv konektora unesite: Tvrtke MCP
U polje Endpoint / Server URL zalijepite: https://tvrtke.podaci.dev/mcp
Odaberite protokol: Streamable HTTP (SSE)
Spremite konektor — autentifikacija nije potrebna za javne podatke

Tehnički parametri krajnje točke:

Endpoint URL: https://tvrtke.podaci.dev/mcp
Transport: Streamable HTTP (SSE)
Protocol Version: 2025-03-26 / 2024-11-05
Authentication: None (Open Data)

Primjeri upita za AI agente

Isprobajte ove upite u svom AI asistentu nakon što dodate Tvrtke MCP poslužitelj:

1. Osnovni upit

Osnovni upit: Profil tvrtke i stvarni vlasnici

Agent poziva pretragu subjekta u Sudskom registru, dohvaća matične podatke te iz FINA RSV registra povlači stvarne vlasnike, upravu i povezana društva.

"Pronađi tko su članovi uprave i stvarni vlasnici tvrtke "Rimac Technology d.o.o.". Prikaži njihov OIB, MBS, pravni oblik, NKD djelatnost i sjedište te s kojim je još tvrtkama isti vlasnik povezan."

Prikaži stvarni rezultat iz registra

Pozvani MCP alati: search_companies get_company_by_id get_company_true_owners search_true_owners

Naziv: Rimac Technology d.o.o. za proizvodnju, trgovinu i usluge

OIB: 70036017051 | MBS: 81402813 | Osnovano: 02.11.2021.

Sjedište: Kerestinečka cesta 54, Kerestinec (Zagrebačka županija)

Pravni oblik: društvo s ograničenom odgovornošću | NKD: 29.31 — Proizvodnja električne i elektroničke opreme za motorna vozila

Uprava / Stvarni vlasnik (FINA RSV): MATE RIMAC (rođ. 02.1988., Brezje) — Kontrolni položaj u upravljanju imovinom pravne osobe (upisan kao direktor sukladno čl. 28. st. 8. ZSPNFT, NN 151/22).

Povezana društva u RSV za istu osobu: Bugatti Rimac d.o.o. (43283914637), Rimac Group d.o.o. (53943536946), moj gruntek d.o.o. (13687660914 — 19,82% izravno vlasništvo).

2. Napredni upit

Napredni upit: Financijska forenzika i analiza rizika

Agent koristi financijski screener za izoliranje tvrtki s netipičnim omjerima prihoda i dobiti, a zatim kroz Registar stvarnih vlasnika (FINA RSV) i sudski registar provjerava vlasničke veze i povijest promjena.

"Napravi financijsku forenziku: filtriraj 10 subjekata s najvećim prihodima koji posluju s nultom ili minimalnom profitabilnošću. Identificiraj tko su stvarni vlasnici u pozadini, njihovu NKD djelatnost te jesu li iste osobe povezane s drugim tvrtkama u Hrvatskoj."

Prikaži stvarni rezultat iz registra

Pozvani MCP alati: search_financial_screener get_company_by_id get_company_true_owners search_true_owners

#	Subjekt	Prihodi (2024)	Neto dobit	Marža	Stvarni vlasnik (RSV)
1.	GNK ASG d.o.o. (Zagreb)	169.456.244 €	12.887 €	0,007%	Nermin Sefić (100%)
2.	MOLARS GROUP d.o.o. (Žabnik)	18.125.400 €	48.820 €	0,269%	Luka Modrić (100%)
3.	SPAZZONI S.E. EUROPE d.o.o. (Zagreb)	17.576.021 €	24.923 €	0,141%	— (inozemni osnivač)
4.	COMPANY MARITIME ADRIATIC j.d.o.o. (Rijeka)	14.599.415 €	2.606 €	0,017%	Džulija Mijolović (100%)
5.	ASTRIA d.o.o. (Stara Gradiška)	13.940.392 €	28.110 €	0,201%	Goran Todorović (100%)
6.	Moro&Kunst d.o.o. Podružnica (Zagreb)	13.267.483 €	13.804 €	0,104%	Podružnica (SI)
7.	MARKOS FOOD d.o.o. (Sesvete)	11.762.969 €	42.073 €	0,357%	Marinko Ojdanić (100%)
8.	SOIN PLASTIKA d.o.o. (Rijeka)	10.616.164 €	11.136 €	0,104%	S. Brysiak (55%), V. Rajković (45%)
9.	FRIGO BONSAI d.o.o. (Metković)	10.005.359 €	32.809 €	0,327%	Nikola Ujdur (100%)
10.	AS24 d.o.o. (Zagreb)	9.019.809 €	41.070 €	0,455%	TotalEnergies / G. Okuka

Primjer povezanih društava iz RSV-a:

• Luka Modrić (rođ. 08.1998., vlasnik MOLARS GROUP d.o.o.) također je upisan kao stvarni vlasnik u ILANGA EYEWEAR d.o.o. (50%) i MS EXPRES d.o.o. (33%).

• Vladimir Rajković (suvlasnik SOIN PLASTIKA d.o.o., 45%) također je 100% vlasnik u AGRO-TURIZAM d.o.o. i NOVA RINAVIS d.o.o. te 80% u I - COM d.o.o.

Izvori podataka

Podaci se sinkroniziraju izravno iz službenih registara u strukturiranu bazu.

Ministarstvo pravosuđa i uprave RH

Sudski registar (Sudreg)

Službeni registar trgovačkih društava, ustanova i drugih pravnih osoba. Sadrži OIB, MBS, pravni oblik, sjedište, datum osnivanja, pretežitu NKD djelatnost, status subjekta i povijest sudskih upisa.

Financijska agencija (FINA)

FINA RGFI (Godišnji financijski izvještaji)

Višegodišnji financijski izvještaji trgovačkih društava: bilanca, račun dobiti i gubitka, poslovni prihodi, neto dobit, kapital i rezerve, imovina, obveze, EBITDA i pojedinačne AOP pozicije.

Financijska agencija (FINA)

FINA RSV (Registar stvarnih vlasnika)

Službena evidencija stvarnih fizičkih osoba i članova uprave koji krajnje posjeduju ili kontroliraju pravne subjekte, uključujući postotke vlasništva, prirodu kontrole i povezana društva.

Dostupni MCP alati

Alati koje vaš AI agent poziva tijekom rada:

get_company_by_id Profil tvrtke po OIB-u ili MBS-u

Dohvaća matični profil pravnog subjekta iz Sudskog registra: puni naziv, OIB, MBS, pravni oblik, adresu sjedišta, datum osnivanja, pretežitu NKD djelatnost i status.

Parametri: identifier (string), identifier_type ('oib' | 'mbs')

search_companies Pretraga tvrtki u Sudskom registru

Fleksibilno pretraživanje subjekata po dijelu naziva, ulici, kućnom broju i podbroju, gradu/naselju, županiji, rasponu datuma osnivanja, NKD kodu djelatnosti i statusu.

Parametri: name, street, house_number, house_subnumber, city, county, nkd_code, inception_date_from, inception_date_to, status

get_company_true_owners Stvarni vlasnici i ovlaštene osobe (RSV)

Dohvaća upisane stvarne vlasnike i direktore iz FINA Registra stvarnih vlasnika (RSV), uključujući postotak udjela, prirodu kontrole, državljanstvo i zakonske napomene.

Parametri: identifier (OIB | MBS)

search_true_owners Pretraga povezanih tvrtki po vlasniku

Pronalazi sve pravne subjekte u Hrvatskoj povezane s određenom fizičkom osobom ili vlasnikom prema imenu, prezimenu, mjesecu/godini rođenja, gradu ili državi.

Parametri: first_name, last_name, birth_month_year, citizenship, residence_country, city, company_name, limit, offset

search_financial_screener Financijski screener i forenzičko filtriranje

Napredno filtriranje i rangiranje tvrtki prema godišnjim izvještajima FINA-e: rasponi ukupnih i poslovnih prihoda, neto dobiti, EBITDA-e, imovine, obveza, kapitala i adekvatnosti kapitala.

Parametri: year, min_total_income, max_total_income, min_net_profit, max_net_profit, min_ebitda, max_ebitda, min_total_assets, min_equity_ratio, is_profitable, city, county, nkd_codes, sort_by, sort_order, limit, offset

get_company_financials Višegodišnji financijski izvještaji (RGFI)

Dohvaća povijesne godišnje financijske izvještaje (GFI/RGFI) predane FINA-i za odabrani raspon godina, uz opciju ispisa svih pojedinačnih AOP pozicija bilance i RDG-a.

Parametri: identifier (OIB | MBS), from_year, to_year, include_aop_lines, aop_filter

get_company_history Povijest sudskih upisa i promjena

Vraća kronološki popis do 100 najnovijih službenih upisa i pravnih promjena zabilježenih u Sudskom registru prema MBS-u subjekta.

Parametri: mbs (string)

get_company_overview Vodič za dubinsku analizu (Due Diligence)

Pruža AI agentu strukturirane upute za dubinsku provjeru subjekata kroz Sudski registar, FINA RGFI i RSV te pravila protiv haluciniranja podataka.

Parametri: query (string)