MCP Server

The Firmium MCP server lets AI agents (Claude, ChatGPT, or your own) query DACH company intelligence: master data, management, shareholders, financials, the relationship graph and a change feed, directly, over the Model Context Protocol. It is the first MCP-native source for Austrian, German and Swiss company data: not static records, but relationships and changes over time, with explicit availability markers so an agent knows what each response contains. Field availability varies by registry. For coverage by country, contact sales@firmium.de.

Endpoint

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

Transport is Streamable HTTP. Authentication is OAuth 2.1: your MCP client discovers the server, registers automatically (Dynamic Client Registration), and runs the PKCE authorization flow. No manual key handling in the client.

Quickstart

Claude Desktop / Code
Any MCP client

Add the server; Claude opens a browser to authorize:

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

Point the client at https://mcp.firmium.de/mcp/. On first connect it performs OAuth 2.1 (discovery → dynamic registration → PKCE) and stores the bearer token.

Authentication & scopes

Tokens are issued by the Firmium authorization server and carry one or more scopes:

Scope	Grants
`companies:read`	Company data: profile, management, shareholders, financials, network, changes, risk
`prospecting:read`	Company discovery by filters (prospecting / lead generation)
`watchdogs:read` / `watchdogs:write`	Read / create monitoring agents (watchdogs)

A call without a valid token, or without the scope a tool requires, is rejected with a clear error. Revoking access takes effect immediately.

Tools

Tools (read-only except create_watchdog), returning structured JSON.

Tool	Arguments	Returns
`search_company`	`query` (min. 2 characters), `country?`, `limit?` (default 20)	Ranked matches with Firmium `uuid`
`get_company`	`uuid`, `sections?` (+ section parameters)	The requested `sections` of a company
`discover_companies`	`filters?`, `query?`, `similar_to_uuid?`, `limit?` (1-100, default 25), `offset?`	Companies matching an ICP (or similar to `similar_to_uuid`), with `uuid`; requires a plan with prospecting
`list_watchdogs`	`limit?` (1-100, default 25), `offset?`	Your monitoring agents
`get_watchdog`	`uuid`, `since?`, `official_only?`, `limit?` (1-200, default 50), `offset?`	One monitoring agent with its companies and signals
`create_watchdog`	`prompt`, `name?`, `company_uuids?`, `tag_names?`	Create a monitoring agent
`validate_vat`	`vat_number`	Verified company name and address for an EU VAT ID or Swiss UID; `valid: false` means not registered
`search`	`query`	ChatGPT connector variant of `search_company` (single argument)
`fetch`	`id`	ChatGPT connector variant: readable profile text for one company `uuid`

The get_company tool returns only the sections you request (default overview). Sections: overview, management, shareholders, ownership_tree, financials, financial_indicators, network, changes, sanctions, insolvency, funding, ip, industry, publications, bank_accounts, employees, alerts. Section parameters: network_depth (1-3, default 1), ownership_depth (1-5, default 3), and for changes the filters changes_since, changes_until, changes_category and official_changes_only.

Section availability

Each section states whether data is included:

Availability: a section reports availability:
- present: data is included,
- not_present: we checked the source and there is none,
- not_loaded: we have not collected it yet.

End-to-end example

Agent prompt: “Who runs Muster Technik GmbH, and is it growing?”

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" } } } }

Pricing

Usage is metered per customer and subject to per-minute and per-day request limits. Contact sales@firmium.de for pricing and volume tiers.

Onboarding

Request access at firmium.de. You get a Firmium account.
Add https://mcp.firmium.de/mcp/ to your MCP client.
Authorize in the browser on first connect (OAuth 2.1, no manual keys).
Start calling tools. Usage is metered automatically.

Get started

API documentation

API Reference

Endpoint

Quickstart

Authentication & scopes

Tools

Section availability

End-to-end example

Pricing

Onboarding

​Endpoint

​Quickstart

​Authentication & scopes

​Tools

​Section availability

​End-to-end example

​Pricing

​Onboarding

Endpoint

Quickstart

Authentication & scopes

Tools

Section availability

End-to-end example

Pricing

Onboarding