MCP-Server für österreichische Firmendaten
Firmenbuch, GISA, Ediktsdatei und Jahresabschlüsse als Werkzeuge für Claude und Cursor. Anmeldung mit dem Firmenakte-Konto, kein Key im Client.
Der Key bleibt im Konto. Der Client sieht ihn nie.
Was ein Agent abfragen kann
Jeder Endpoint der API ist ein Werkzeug. Der Agent wählt selbst, welches er braucht.
| Bereich | Werkzeuge |
| Unternehmen | Screener mit Filtern nach Ort, Rechtsform, Branche und Aktiv-Status. Firmenprofil, ähnliche Unternehmen, Treffermenge, Namensindex. |
| Personen | Suche nach Name oder Funktion, Personenprofil mit allen eingetragenen Funktionen. |
| Verflechtungen | Beteiligungs- und Funktionsgraph zu einem Unternehmen oder einer Person. |
| Gewerbe | GISA-Katalog, Berechtigungen einer Firma, Gewerbeauszug als Dokument. |
| Edikte und Dokumente | Ediktsdatei-Feed, Jahresabschlüsse und weitere Dokumente. |
| Änderungen | Was sich seit einem Zeitpunkt getan hat, einzeln je Quelle oder gebündelt. |
| Kataloge | ÖNACE, Rechtsformen, Firmenbuchgerichte, Funktionscodes, Orte und Postleitzahlen. |
Werkzeugnamen folgen den Routen: aus GET /api/v1/businesses/{fnr} wird GET_apiv1businessesfnr. Alle Werkzeuge und ihre Parameter in der API-Referenz.
Einrichten
Dieselbe Konfiguration in jedem Client. Beim ersten Verbinden öffnet sich die Anmeldung bei Firmenakte.
{
"mcpServers": {
"firmenakte": {
"url": "https://mcp.firmenakte.at/mcp"
}
}
}Endpoint
Transport
Anmeldung
Aufrufe
Verbinden und fragen
Konfiguration einfügen, beim ersten Aufruf mit dem Firmenakte-Konto anmelden. Ein API-Key muss im Konto angelegt sein, mehr braucht der Server nicht.
Häufige Fragen
Wie frage ich das Firmenbuch in Claude ab?
Server als MCP-Verbindung in Claude Desktop eintragen, beim ersten Verbinden mit dem Firmenakte-Konto anmelden. Danach genügt eine Frage wie „Wer ist bei der PORR AG zeichnungsberechtigt?“, Claude ruft das passende Werkzeug selbst auf.
Brauche ich einen API-Key für den MCP-Server?
Im Client nicht. Der Client meldet sich über OAuth mit dem Firmenakte-Konto an, der Server verwendet den API-Key dieses Kontos serverseitig. Ohne einen im Dashboard angelegten Key antwortet die API mit 401.
Kann ein Agent nach Bilanzkennzahlen filtern?
Ja. Die Range-Filter auf einzelne Bilanz- und GuV-Werte stecken in den Screener-Werkzeugen im kompakten Parameter figures, den der Server vor dem Aufruf wieder in die einzelnen Filter auflöst: als 92 eigene Parameter wäre das Eingabeschema so groß, dass Clients das Werkzeug verwerfen. Ort, PLZ, ÖNACE, Rechtsform, Mitarbeiteranzahl und Aktiv-Status bleiben eigene Parameter, und über die REST-API sind alle Kennzahlen unverändert filterbar.
Welche Clients funktionieren?
Jeder MCP-Client mit Streamable HTTP und OAuth, etwa Claude Desktop oder Cursor. Die Konfiguration ist überall dieselbe: Name und URL des Servers.