Zum Hauptinhalt springen
Der Firmium MCP-Server lässt KI-Agenten (Claude, ChatGPT oder eigene) DACH-Unternehmensdaten abfragen — Stammdaten, Management, Gesellschafter, Finanzen, den Beziehungsgraph und einen Änderungs-Feed — direkt über das Model Context Protocol. Es ist die erste MCP-native Quelle für österreichische, deutsche und Schweizer Unternehmensdaten: keine statischen Datensätze, sondern Beziehungen und Veränderungen über die Zeit, jedes Feld mit seiner Herkunft markiert, damit ein Agent weiß, worauf er sich verlassen kann.

​
Endpoint

https://mcp.firmium.de/mcp/
Transport ist Streamable HTTP. Authentifizierung ist OAuth 2.1 — dein MCP-Client findet den Server, registriert sich automatisch (Dynamic Client Registration) und durchläuft den PKCE-Authorization-Flow. Kein manuelles Schlüssel-Handling im Client.

​
Schnellstart

Server hinzufügen; Claude öffnet einen Browser zur Autorisierung:
{
  "mcpServers": {
    "firmium": {
      "type": "http",
      "url": "https://mcp.firmium.de/mcp/"
    }
  }
}

​
Authentifizierung & Scopes

Tokens werden vom Firmium-Authorization-Server ausgestellt und tragen einen oder mehrere Scopes:
ScopeErlaubt
companies:readUnternehmensdaten: Profil, Management, Gesellschafter, Finanzen, Netzwerk, Änderungen, Risiko
prospecting:readFirmensuche per Filter (Prospecting / Lead-Generierung)
watchdogs:read / watchdogs:writeMonitoring-Agenten (Watchdogs) lesen / anlegen
Ein Aufruf ohne gültigen Token oder ohne den vom Tool benötigten Scope wird mit einer klaren Fehlermeldung abgelehnt. Ein Entzug des Zugriffs wirkt sofort.

​
Tools

Vier Tools (read-only außer manage_watchdogs create), die strukturiertes JSON zurückgeben.
ToolArgumenteLiefert
search_companyquery, country?, limit?Gerankte Treffer mit Firmium-uuid
get_companyuuid, sections? (+ Section-Parameter)Die angefragten sections eines Unternehmens
discover_companiesfilters?, query?, limit?, offset?Firmen, die zum ICP passen, mit uuid
manage_watchdogsaction (list/events/create), …Monitoring-Agenten und ihre Signale
Das get_company-Tool liefert nur die angefragten sections (Default overview). Sections: overview, management, shareholders, ownership_tree, financials, financial_indicators, network, changes, sanctions, insolvency, ip, industry, publications, bank_accounts, employees, alerts.

​
Vertrauenssignale (warum Agenten sich darauf verlassen können)

Jede Antwort macht Herkunft und Lücken explizit, damit ein Agent eine Lücke nie für eine Tatsache hält:
  • Herkunft — Beziehungen und Kanten sind official_registry (im Handelsregister erfasst) oder derived (abgeleitet). Abgeleitete Daten tragen confidence: low.
  • Datenlücken — eine fehlende Section meldet availability:
    • present — Daten sind enthalten,
    • not_present — wir haben die Quelle geprüft, es gibt keine,
    • not_loaded — wir haben sie noch nicht erhoben.

​
End-to-End-Beispiel

Agent-Prompt: „Wer führt die Muster Technik GmbH, und wächst sie?” 
1. search_company(query="Muster Technik GmbH")
   → { count: 1, results: [{ uuid: "…", name: "Muster Technik GmbH", status: "Active" }] }

2. get_company(uuid="…", sections=["management", "financials"])
   → { company: { name: "Muster Technik GmbH", status: "Active" },
       sections: {
         management: { items: [{ party: { full_name: "Max Muster" },
                                 relationship_type: "managing_director",
                                 provenance: { source: "official_registry", confidence: "high" } }] },
         financials: { years: [{ year: 2024, revenue: "1500000.00" }, …],
                       data_status: { availability: "present" } } } }

​
Preise

Nutzungsbasiert: du zahlst pro erfolgreichem Tool-Call. Fehlgeschlagene und rate-limitierte Calls werden nicht berechnet. Jeder Kunde hat ein Budget pro Minute und pro Tag. Für Volumen-Staffeln sprich uns an.

​
Onboarding

  1. Zugang anfragen auf firmium.de — du bekommst ein Firmium-Konto.
  2. https://mcp.firmium.de/mcp/ zu deinem MCP-Client hinzufügen.
  3. Beim ersten Verbinden im Browser autorisieren (OAuth 2.1, keine manuellen Schlüssel).
  4. Tools aufrufen — die Nutzung wird automatisch gemetert.