MCP Server

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, mit expliziten Verfügbarkeits-Markern, damit ein Agent weiß, was eine Antwort enthält. Welche Felder pro Land vorliegen, hängt vom Register ab. Für die Abdeckung nach Land: sales@firmium.de.

Endpoint

https://mcp.firmium.de/mcp/

Transport ist Streamable HTTP. Authentifizierung ist OAuth 2.1: Ihr 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

Claude Desktop / Code
Beliebiger MCP-Client

Server hinzufügen; Claude öffnet einen Browser zur Autorisierung:

{
  "mcpServers": {
    "firmium": {
      "type": "http",
      "url": "https://mcp.firmium.de/mcp/"
    }
  }
}

Den Client auf https://mcp.firmium.de/mcp/ richten. Beim ersten Verbinden läuft OAuth 2.1 (Discovery → Dynamic Registration → PKCE) und der Bearer-Token wird gespeichert.

Authentifizierung & Scopes

Tokens werden vom Firmium-Authorization-Server ausgestellt und tragen einen oder mehrere Scopes:

Scope	Erlaubt
`companies:read`	Unternehmensdaten: Profil, Management, Gesellschafter, Finanzen, Netzwerk, Änderungen, Risiko
`prospecting:read`	Firmensuche per Filter (Prospecting / Lead-Generierung)
`watchdogs:read` / `watchdogs:write`	Monitoring-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

Tools (read-only außer create_watchdog), die strukturiertes JSON zurückgeben.

Tool	Argumente	Liefert
`search_company`	`query` (mind. 2 Zeichen), `country?`, `limit?` (Default 20)	Gerankte Treffer mit Firmium-`uuid`
`get_company`	`uuid`, `sections?` (+ Section-Parameter)	Die angefragten `sections` eines Unternehmens
`discover_companies`	`filters?`, `query?`, `similar_to_uuid?`, `limit?` (1-100, Default 25), `offset?`	Firmen, die zum ICP passen (oder ähnlich zu `similar_to_uuid`), mit `uuid`; erfordert einen Tarif mit Prospecting
`list_watchdogs`	`limit?` (1-100, Default 25), `offset?`	Ihre Monitoring-Agenten
`get_watchdog`	`uuid`, `since?`, `official_only?`, `limit?` (1-200, Default 50), `offset?`	Ein Monitoring-Agent mit Firmen und Signalen
`create_watchdog`	`prompt`, `name?`, `company_uuids?`, `tag_names?`	Monitoring-Agent anlegen
`validate_vat`	`vat_number`	Verifizierter Firmenname und Adresse zu einer EU-USt-IdNr. oder Schweizer UID; `valid: false` bedeutet nicht registriert
`search`	`query`	ChatGPT-Connector-Variante von `search_company` (ein Argument)
`fetch`	`id`	ChatGPT-Connector-Variante: lesbarer Profiltext zu einer Firmen-`uuid`

Das get_company-Tool liefert nur die angefragten sections (Default overview). Sections: overview, management, shareholders, ownership_tree, financials, financial_indicators, network, changes, sanctions, insolvency, funding, ip, industry, publications, bank_accounts, employees, alerts. Section-Parameter: network_depth (1-3, Default 1), ownership_depth (1-5, Default 3) sowie für changes die Filter changes_since, changes_until, changes_category und official_changes_only.

Verfügbarkeit je Abschnitt

Jeder Abschnitt gibt an, ob Daten enthalten sind:

Verfügbarkeit: ein Abschnitt 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: { uuid: "…", name: "Muster Technik GmbH", legal_form: "GmbH", status: "Active" },
       sections: {
         management: { count: 1, items: [{ party: { full_name: "Max Muster" },
                                 relationship_type: "managing_director",
                                 is_active: true }],
                       data_status: { availability: "present" } },
         financials: { count: 5, years: [{ year: 2024, revenue: "1500000.00" }, …],
                       data_status: { availability: "present" } } } }

Preise

Die Nutzung wird pro Kunde gemessen und unterliegt Anfragelimits pro Minute und pro Tag. Für Preise und Volumen-Staffeln schreib an sales@firmium.de.

Onboarding

Zugang anfragen auf firmium.de. Sie erhalten ein Firmium-Konto.
https://mcp.firmium.de/mcp/ zu Ihrem MCP-Client hinzufügen.
Beim ersten Verbinden im Browser autorisieren (OAuth 2.1, keine manuellen Schlüssel).
Tools aufrufen. Die Nutzung wird automatisch gemetert.

Allgemein

API Dokumentation

API Reference

Endpoint

Schnellstart

Authentifizierung & Scopes

Tools

Verfügbarkeit je Abschnitt

End-to-End-Beispiel

Preise

Onboarding

​Endpoint

​Schnellstart

​Authentifizierung & Scopes

​Tools

​Verfügbarkeit je Abschnitt

​End-to-End-Beispiel

​Preise

​Onboarding

Endpoint

Schnellstart

Authentifizierung & Scopes

Tools

Verfügbarkeit je Abschnitt

End-to-End-Beispiel

Preise

Onboarding