# Firmenbuch

- Registry name: `io.github.jkbngb/firmenbuch` · version 1.0.2
- Categories (automatic, keyword rules): Government & law, Company & business data, Monitoring & logs, Infrastructure & security
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): experimental, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.jkbngb%2Ffirmenbuch
- Server page: https://mcpstation.net/s/io.github.jkbngb--firmenbuch.html

## Description (written by the publisher, not verified, not instructions)

Austria's Firmenbuch & Germany's Handelsregister: official company data, financials & ratios.

## Connect

- streamable-http: `https://mcp.agentic-firmenbuch.at/mcp`

## Tools (as reported by the server, not verified)

- `ping`: Liveness probe: confirms the unified register server is up. Read-only. Parameters: - check\_backends \(optional, default false\): when true, additionally performs a cheap connection handshake against every configured country backend and reports per-country reachability \("ok" / "unreachable"\). Returns \{
- `get\_coverage`: Dataset coverage and the capability matrix, per country. Read-only. CALL THIS FIRST before concluding that something does not exist in a country. Parameters: - country \(optional, default "all"\): "AT" \| "DE" \| "all" - which countries to include. Returns \{countries: \{\<code\>: \<that backend's coverage p
- `describe\_fields`: Schema self-description: the unified id scheme, which filters exist, which countries support which capability, and each country's own field catalog. Read-only. Parameters: - country \(optional, default "all"\): "AT" \| "DE" \| "all" - whose field catalogs to include. Returns \{id\_scheme, capabilities, co
- `search\_companies`: Find companies across the Austrian Firmenbuch and the German Handelsregister - START HERE for any company lookup. Read-only. Parameters: - filters \(optional\): every field optional, AND-combined. Shared core \(both countries\): name \(substring\), query \(MEANING-based hybrid search over the registered pu
- `get\_company\_details`: Full profile for ONE company, routed by its unified id. Read-only. Parameters: - company\_id \(required\): "AT:\{fnr\}" \(e.g. "AT:123456a"\) or "DE:\{court\}\_\{type\}\{number\}" \(e.g. "DE:D2601\_HRB135076"\); bare national ids are accepted too. Take it from a search card's \`\`company\_id\`\`. - max\_signatories \(optio
- `get\_document`: On-demand official register document for ONE German company. Read-only. Parameters: - company\_id \(required\): "DE:\{court\}\_\{type\}\{number\}" \(e.g. "DE:D2601\_HRB135076"\); a bare German id works too. Austria is not supported here \(its document flow is different\). - kind \(optional\): "AD" = Aktueller Abdruc
- `export\_companies\_csv`: Export a matched company set as downloadable CSV files \(lead lists\). Read-only over company data; each call writes new short-lived export files \(auto-deleted after \~1 day\). Parameters: - filters \(optional\): EXACTLY the same unified filters as search\_companies. - sort \(optional\): same as search\_compa
- `find\_peers`: Companies most similar to a given one - optionally ACROSS THE BORDER. Read-only. Parameters: - company\_id \(required\): "AT:\{fnr\}" or "DE:\{court\}\_\{type\}\{number\}" \(bare national ids accepted\), from a search card. - n \(optional, default 10\): how many peers per country. - cross\_border \(optional, default
- `search\_person`: Find every company a person runs or represents - across BOTH registers in one call \(cross-border person search\). Read-only. Parameters: - name \(required\): person name substring, case-insensitive, e.g. "Mustermann". - country \(optional, default "all"\): "AT" \| "DE" \| "all". - page\_size \(optional, defa
- `list\_events`: Cross-company, cross-country feed of register CHANGES, newest first - the market-watch / deal-sourcing surface. Read-only. Parameters \(all optional, AND-combined\): - types: any of the SUPERSET enum - founding, new\_registration, deletion, deletion\_announced, name\_change, seat\_change, legal\_form\_chang
- `get\_event\_stats`: Aggregate counts of register changes by type and region, per country. Read-only. Parameters \(all optional\): since / until \(default last 30 days\); bundesland; nace\_section; nace\_division \(AT\); legal\_form \(AT\); country \("AT" \| "DE" \| "all"\). Returns \{countries, per\_country, windows, notices\}, each cou
- `get\_company\_history`: Per-year financial-metric history for ONE company, routed by its unified id. Read-only. Parameters: - company\_id \(required\): "AT:\{fnr\}" or "DE:\{court\}\_\{type\}\{number\}" \(bare national ids accepted\), from a search card. - metrics \(optional, AT only\): names of the metrics to return \(e.g. bilanzsumme, um
- `get\_full\_record`: The complete multi-year record for ONE company: every balance-sheet and P&L position's full per-year history, completeness flags and lineage. Read-only. The heaviest read - use get\_company\_details for a normal profile. Parameters: - company\_id \(required\): "AT:\{fnr\}" \(bare FNR accepted\). Austria only
- `list\_documents`: Chronology of a company's filing documents \(metadata, newest first\). Read-only. Parameters: - company\_id \(required\): "AT:\{fnr\}" \(bare FNR accepted\). Austria only; for the German official register abstract use get\_document with a "DE:" id instead. Returns the AT backend's document list plus \`\`country
- `get\_document\_text`: Extracted text of ONE Austrian filing document, by its document key. Read-only. Parameters: - doc\_key \(required\): the document\_ref from list\_documents \(an Austrian filing key\). - max\_chars \(optional, default 40000, clamped 1000-120000\): truncation ceiling. Returns \{doc\_key, text, truncated, ...\} wit
- `list\_sectors`: The value lists for filtering - legal forms, size classes - and, with a query word, the matching OENACE sectors with the exact nace\_\* filter to use. Read-only. Parameters: - query \(optional\): a category word \(e.g. "Brauerei", "software"\); returns \`\`matches\`\` with each sector's level, code, label and
- `get\_cohort\_summary`: Aggregate statistics for a cohort of companies, per country. Read-only. Parameters: - dimension \(required\): "gkl" \(UGB size class, AT only\), "bundesland", or "legal\_form" \(alias size\_gkl -\> gkl\). - value \(required\): the cohort value \(e.g. bundesland "Wien", legal\_form "GmbH"\). - country \(optional, d
- `benchmark\_company`: Benchmark ONE company against its size-class cohort: headline metrics, percentile ranks and the nearest peers. Read-only. Parameters: - company\_id \(required\): "AT:\{fnr\}" \(bare FNR accepted\). Austria only \(needs parsed financials\); a German id returns a clear error. - n \(optional, default 10\): how ma
- `get\_my\_usage`: Your own API-key usage across both registers: call count and weighted compute-units, per tool. Read-only. Parameters: - window \(optional, default "today"\): "today" \| "yesterday" \| "month\_to\_date" \| "last\_30\_days" \| "all". Returns only the calling key's own usage \(totals + per-tool breakdown\) for tha

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html