Handelsregister

Official11 tools

by jkbngb · Python

German Handelsregister + Austrian Firmenbuch for AI agents: master data, financials & ratios.

io.github.jkbngb/handelsregister (MCP Server)

The io.github.jkbngb/handelsregister MCP server provides German Handelsregister and Austrian Firmenbuch data for AI agents, including master data, financials, and key ratios. It is described as a live, automated data product served through a multi-tenant MCP server, with query responses based on real register data.

🛠️ Key Features

German Handelsregister and Austrian Firmenbuch coverage
Master data, financials, and key ratios
Multi-tenant MCP server
AI-agent queries in plain language
Topics include mcp, model-context-protocol, company-data, company-register, and high-value-datasets

🚀 Use Cases

Retrieving official register information for firms
Accessing annual accounts and key ratios via MCP
Using the dataset as an input for AI-driven company analysis workflows

⚡ Developer Benefits

Tooling integration via model-context-protocol (MCP)
Structured access to company-register data described as “official master data”
Associated developer entrypoints referenced in the excerpt (playground and quickstart)

⚠️ Limitations

The provided description is based on the server excerpt; it does not specify authentication, schemas, or full tool list details (toolCount is 11).

Topics

ai-agentsaustriaazurecompany-dataetlfirmenbuchllm-toolsmcpmodel-context-protocolopen-datapythonhigh-value-datasetscompany-register

Captured live from the server via tools/list.

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 {status, server, countries, provenance} - countries maps each configured country code to its backend product name and, with check_backends, its live reachability. Use get_coverage for data completeness; this tool only says whether the service is up.

Parameters1

check_backends

boolean

optional

Raw schema

{
  "type": "object",
  "properties": {
    "check_backends": {
      "default": false,
      "title": "Check Backends",
      "type": "boolean"
    }
  },
  "title": "pingArguments"
}

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 payload>}, capabilities, countries_unavailable}. Each country section is the country backend's own coverage dashboard (AT: parsed-financials counts by format/status; DE: per-Bundesland counts + fill rates - the DE backfill is still running, so a low count means "not crawled yet", not "does not exist"). ``capabilities`` is the machine-readable matrix of what each country supports (financials, documents, events windows, filters); a country that cannot be reached appears under ``countries_unavailable`` with the error instead of failing the whole call. For valid filter values use describe_fields; for per-company data use search_companies.

Parameters1

country

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "default": "all",
      "title": "Country",
      "type": "string"
    }
  },
  "title": "get_coverageArguments"
}

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, countries, countries_unavailable}. ``id_scheme`` documents the unified company_id ("AT:123456a", "DE:D2601_HRB135076"; bare national ids are accepted, responses always return the prefixed form). ``capabilities`` is the per-country capability matrix including each country's supported unified filters - a filter absent for a country is applied to the others and reported in a notice, never silently dropped. ``countries`` carries each backend's own describe_fields payload (code tables, null rules, tool tiers). Call once up front when unsure which filter or tool to use; it returns no company data itself.

Parameters1

country

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "default": "all",
      "title": "Country",
      "type": "string"
    }
  },
  "title": "describe_fieldsArguments"
}

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 purpose - both countries), status (active|inactive|all, default all), legal_form, bundesland, city, postal_code (prefix; AT PLZ 4-digit, DE 5-digit), near {place | postal_code, radius_km} (radius search, matches from EVERY queried country within the radius - works across the border), nace_section (A-U; OENACE == WZ == NACE Rev. 2, so one industry code filters both countries), gegenstand (literal substring over the registered activity text), manager_name (person search), company_ids (prefixed watchlist, e.g. ["AT:123456a", "DE:D2601_HRB135076"], max 100). AT-only today (see describe_fields capabilities): nace_division/group, size_gkl, bilanzsumme/revenue/equity_ratio/ employees ranges, growth_profile, has_guv(_latest), last_filing_year_min, founded_year_min/max, gf_age_min, event_signal/since/until. DE-only: registergericht, capital_min/max (Stammkapital). Country aliases (geschaeftszweig, oenace_*, wz_section, fnrs, stammkapital_*) are accepted. - sort (optional): {field, descending}. AT fields: bilanzsumme (default), revenue, equity_ratio, employees, last_filing_year, revenue_growth_1y/3y/5y, distance. DE fields: name, register_nummer, capital. A country that cannot sort by the requested field returns its default order (reported in notices). - page (default 1), page_size (default 25). - after (optional): KEYSET paging for bulk extraction - single country only (cursors are per register). Pass "" to start, then the country's next_after from per_country. - exact_count (optional, default false): force exact totals (costs a full scan). - country (optional, default "all"): "AT" | "DE" | "all". Returns {countries, total: {AT, DE, combined}, results, per_country, notices}. ``results`` are compact cards, each with ``country`` and the prefixed ``company_id``; with country="all" the list is AT block then DE block - each country keeps its own ranking (no fake interleave). ``per_country`` carries each register's own envelope (exact totals or lower bounds, applied_filters, relaxations on zero hits, query_mode, next_after). A filter one country does not support excludes that country and says so in ``notices`` - it is never silently dropped; an unreachable backend appears in ``countries_unavailable`` instead of failing the call. Never report a German company's financials as zero - DE financial data is not covered yet (see get_coverage). For one company's full profile use get_company_details; for a downloadable list use export_companies_csv; for dataset completeness use get_coverage.

Parameters7

filters	any	optional
sort	any	optional
page	integer	optional
page_size	integer	optional
after	any	optional
exact_count	boolean	optional
country	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "filters": {
      "anyOf": [
        {
          "$ref": "#/$defs/UnifiedSearchFilters"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "sort": {
      "anyOf": [
        {
          "$ref": "#/$defs/Sort"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "page": {
      "default": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 25,
      "title": "Page Size",
      "type": "integer"
    },
    "after": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "After"
    },
    "exact_count": {
      "default": false,
      "title": "Exact Count",
      "type": "boolean"
    },
    "country": {
      "default": "all",
      "title": "Country",
      "type": "string"
    }
  },
  "$defs": {
    "NearFilter": {
      "description": "Radius anchor: EXACTLY ONE of ``place`` (town name) or ``postal_code``.\nAT postal codes are 4 digits, DE 5 digits - in a cross-country query the postal-code\nanchor therefore pins the anchor country, but matches still come from every queried\ncountry within the radius.",
      "properties": {
        "place": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Place"
        },
        "postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Postal Code"
        },
        "radius_km": {
          "default": 25,
          "title": "Radius Km",
          "type": "number"
        }
      },
      "title": "NearFilter",
      "type": "object"
    },
    "Sort": {
      "description": "Sort request; fields are validated per country (see capabilities.SORT_FIELDS).",
      "properties": {
        "field": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Field"
        },
        "descending": {
          "default": true,
          "title": "Descending",
          "type": "boolean"
        }
      },
      "title": "Sort",
      "type": "object"
    },
    "UnifiedSearchFilters": {
      "description": "Every field optional, AND-combined. A filter a country does not support excludes\nthat country from a country=\"all\" fan-out (with an explicit notice); on an explicit\nsingle-country query it is rejected with the capability notice instead.",
      "properties": {
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "query": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Query"
        },
        "status": {
          "default": "all",
          "enum": [
            "active",
            "inactive",
            "all"
          ],
          "title": "Status",
          "type": "string"
        },
        "legal_form": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Legal Form"
        },
        "bundesland": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Bundesland"
        },
        "city": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "City"
        },
        "postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Postal Code"
        },
        "near": {
          "anyOf": [
            {
              "$ref": "#/$defs/NearFilter"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "nace_section": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Nace Section"
        },
        "gegenstand": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Gegenstand"
        },
        "manager_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Manager Name"
        },
        "company_ids": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Ids"
        },
        "nace_division": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Nace Division"
        },
        "nace_group": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Nace Group"
        },
        "size_gkl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Size Gkl"
        },
        "bilanzsumme_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Bilanzsumme Min"
        },
        "bilanzsumme_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Bilanzsumme Max"
        },
        "revenue_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Revenue Min"
        },
        "revenue_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Revenue Max"
        },
        "equity_ratio_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Equity Ratio Min"
        },
        "equity_ratio_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Equity Ratio Max"
        },
        "employees_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Employees Min"
        },
        "employees_max": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Employees Max"
        },
        "growth_profile": {
          "anyOf": [
            {
              "enum": [
                "shrinking",
                "stable",
                "growing",
                "fast_growing"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Growth Profile"
        },
        "has_guv": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Has Guv"
        },
        "has_guv_latest": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Has Guv Latest"
        },
        "last_filing_year_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Filing Year Min"
        },
        "founded_year_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Founded Year Min"
        },
        "founded_year_max": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Founded Year Max"
        },
        "gf_age_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Gf Age Min"
        },
        "event_signal": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Signal"
        },
        "event_since": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Since"
        },
        "event_until": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Until"
        },
        "registergericht": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Registergericht"
        },
        "capital_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Capital Min"
        },
        "capital_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Capital Max"
        },
        "geschaeftszweig": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Geschaeftszweig"
        },
        "wz_section": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Wz Section"
        },
        "oenace_section": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Oenace Section"
        },
        "oenace_division": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Oenace Division"
        },
        "oenace_group": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Oenace Group"
        },
        "fnrs": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Fnrs"
        },
        "stammkapital_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Stammkapital Min"
        },
        "stammkapital_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Stammkapital Max"
        }
      },
      "title": "UnifiedSearchFilters",
      "type": "object"
    }
  },
  "title": "search_companiesArguments"
}

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 (optional, DE only): cap on the served officer list (DE default 15, 0 = all); ignored for AT. Returns the country backend's full profile plus ``country`` and the prefixed ``company_id``. AT: identity, location, per-year Bilanz + GuV, ratios, growth, filings, management, events. DE: identity, seat, Stammkapital, Gegenstand, WZ/NACE classification, managing directors (birth year only) - German financial statements are not covered yet, so never report them as zero or missing. Unknown id -> {error: not_found}. Use search_companies first when you only have a name.

Parameters2

company_id	string	required
max_signatories	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "string"
    },
    "max_signatories": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Signatories"
    }
  },
  "required": [
    "company_id"
  ],
  "title": "get_company_detailsArguments"
}

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_companies (applies where the country supports the field). - max_rows (optional, default 1000, max 10000): per-country row ceiling. - country (optional, default "all"): "AT" | "DE" | "all". Returns {countries: {<code>: {download_url, rows, columns, ...}}, notices}. ONE CSV per country (semicolon-separated, UTF-8 BOM, Excel-ready): each register exports its own column set - DE files have no financial columns yet (blank would wrongly read as zero). Download links are signed and valid ~60 minutes. A filter a country does not support excludes that country with a notice, like search_companies. For browsing/ranking on screen use search_companies instead.

Parameters4

filters	any	optional
sort	any	optional
max_rows	integer	optional
country	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "filters": {
      "anyOf": [
        {
          "$ref": "#/$defs/UnifiedSearchFilters"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "sort": {
      "anyOf": [
        {
          "$ref": "#/$defs/Sort"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "max_rows": {
      "default": 1000,
      "title": "Max Rows",
      "type": "integer"
    },
    "country": {
      "default": "all",
      "title": "Country",
      "type": "string"
    }
  },
  "$defs": {
    "NearFilter": {
      "description": "Radius anchor: EXACTLY ONE of ``place`` (town name) or ``postal_code``.\nAT postal codes are 4 digits, DE 5 digits - in a cross-country query the postal-code\nanchor therefore pins the anchor country, but matches still come from every queried\ncountry within the radius.",
      "properties": {
        "place": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Place"
        },
        "postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Postal Code"
        },
        "radius_km": {
          "default": 25,
          "title": "Radius Km",
          "type": "number"
        }
      },
      "title": "NearFilter",
      "type": "object"
    },
    "Sort": {
      "description": "Sort request; fields are validated per country (see capabilities.SORT_FIELDS).",
      "properties": {
        "field": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Field"
        },
        "descending": {
          "default": true,
          "title": "Descending",
          "type": "boolean"
        }
      },
      "title": "Sort",
      "type": "object"
    },
    "UnifiedSearchFilters": {
      "description": "Every field optional, AND-combined. A filter a country does not support excludes\nthat country from a country=\"all\" fan-out (with an explicit notice); on an explicit\nsingle-country query it is rejected with the capability notice instead.",
      "properties": {
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "query": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Query"
        },
        "status": {
          "default": "all",
          "enum": [
            "active",
            "inactive",
            "all"
          ],
          "title": "Status",
          "type": "string"
        },
        "legal_form": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Legal Form"
        },
        "bundesland": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Bundesland"
        },
        "city": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "City"
        },
        "postal_code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Postal Code"
        },
        "near": {
          "anyOf": [
            {
              "$ref": "#/$defs/NearFilter"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "nace_section": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Nace Section"
        },
        "gegenstand": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Gegenstand"
        },
        "manager_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Manager Name"
        },
        "company_ids": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company Ids"
        },
        "nace_division": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Nace Division"
        },
        "nace_group": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Nace Group"
        },
        "size_gkl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Size Gkl"
        },
        "bilanzsumme_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Bilanzsumme Min"
        },
        "bilanzsumme_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Bilanzsumme Max"
        },
        "revenue_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Revenue Min"
        },
        "revenue_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Revenue Max"
        },
        "equity_ratio_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Equity Ratio Min"
        },
        "equity_ratio_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Equity Ratio Max"
        },
        "employees_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Employees Min"
        },
        "employees_max": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Employees Max"
        },
        "growth_profile": {
          "anyOf": [
            {
              "enum": [
                "shrinking",
                "stable",
                "growing",
                "fast_growing"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Growth Profile"
        },
        "has_guv": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Has Guv"
        },
        "has_guv_latest": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Has Guv Latest"
        },
        "last_filing_year_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Filing Year Min"
        },
        "founded_year_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Founded Year Min"
        },
        "founded_year_max": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Founded Year Max"
        },
        "gf_age_min": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Gf Age Min"
        },
        "event_signal": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Signal"
        },
        "event_since": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Since"
        },
        "event_until": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Event Until"
        },
        "registergericht": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Registergericht"
        },
        "capital_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Capital Min"
        },
        "capital_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Capital Max"
        },
        "geschaeftszweig": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Geschaeftszweig"
        },
        "wz_section": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Wz Section"
        },
        "oenace_section": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Oenace Section"
        },
        "oenace_division": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Oenace Division"
        },
        "oenace_group": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Oenace Group"
        },
        "fnrs": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Fnrs"
        },
        "stammkapital_min": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Stammkapital Min"
        },
        "stammkapital_max": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Stammkapital Max"
        }
      },
      "title": "UnifiedSearchFilters",
      "type": "object"
    }
  },
  "title": "export_companies_csvArguments"
}

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 false): when true, additionally returns ``peers_abroad`` - the companies in the OTHER country whose registered purpose is semantically closest to the reference company's activity text. Returns {company_id, country, peers_home, home_envelope, peers_abroad?, notes}. ``peers_home`` uses the home register's own peer logic (AT: same size class, same industry preferred, nearest by Bilanzsumme; DE: semantic-first by registered purpose). ``peers_abroad`` is a MEANING-based match, not a size or financial benchmark - the honest cross-border comparison given the countries' different data depth (see notes). Empty peers_home means the id is unknown or the company lacks the data its register ranks by. For a strict filtered list use search_companies; for aggregates use the country server's cohort tools.

Parameters3

company_id	string	required
n	integer	optional
cross_border	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "string"
    },
    "n": {
      "default": 10,
      "title": "N",
      "type": "integer"
    },
    "cross_border": {
      "default": false,
      "title": "Cross Border",
      "type": "boolean"
    }
  },
  "required": [
    "company_id"
  ],
  "title": "find_peersArguments"
}

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, default 25): results per country. - status (optional, default "all"): "active" | "inactive" | "all". Returns the merged search_companies envelope ({countries, results, per_country, notices}) plus ``person_query``; every result card carries ``country``, ``company_id`` and the matched manager. AT matches the primary managing director, DE matches all managing directors AND registered signatories. IMPORTANT: matching is by name and the registers publish birth YEAR only - a shared name across companies or countries does not prove the same person (the notice says so; use birth years and context to corroborate). For general company search use search_companies with other filters; manager_name can be combined there too.

Parameters4

name	string	required
country	string	optional
page_size	integer	optional
status	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "country": {
      "default": "all",
      "title": "Country",
      "type": "string"
    },
    "page_size": {
      "default": 25,
      "title": "Page Size",
      "type": "integer"
    },
    "status": {
      "default": "all",
      "title": "Status",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "title": "search_personArguments"
}

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_change, capital_change, management_change, management_join, management_leave, gegenstand_change, merger, split, conversion, contribution, consolidation, division, shareholder_capital_change. Each country's feed carries a SUBSET; a type not in a country's feed is skipped for that country (reported in notices), and a country with none of the requested types is excluded. Note new_registration (DE, a discovery date) and founding (AT, a register event) are distinct - see describe_fields. - since / until: ISO dates. Default window: last 30 days. - bundesland: full state name. - nace_section (A-U, both countries); nace_division (AT only); legal_form (AT only). - company_ids: prefixed watchlist; AT filters the whole list, DE filters ONE id at a time (pass a single DE id, or query DE separately). - country: "AT" | "DE" | "all" (default). page (1), page_size (25). Returns {countries, events, per_country, windows, notices}. ``events`` are merged newest-first, each with ``country`` and a prefixed ``company_id``; AT events add before/after values only for the detailed types. ``windows`` states each country's data availability (AT: detailed >= 2026-07-01, coarse >= ~2020; DE: >= 2026-07-30) so an empty stretch is never mistaken for missing data. For aggregate counts use get_event_stats; for one company's history use get_company_details.

Parameters11

types	any	optional
since	any	optional
until	any	optional
bundesland	any	optional
nace_section	any	optional
nace_division	any	optional
legal_form	any	optional
company_ids	any	optional
country	string	optional
page	integer	optional
page_size	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "types": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Types"
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Since"
    },
    "until": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Until"
    },
    "bundesland": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Bundesland"
    },
    "nace_section": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Nace Section"
    },
    "nace_division": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Nace Division"
    },
    "legal_form": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Legal Form"
    },
    "company_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Ids"
    },
    "country": {
      "default": "all",
      "title": "Country",
      "type": "string"
    },
    "page": {
      "default": 1,
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 25,
      "title": "Page Size",
      "type": "integer"
    }
  },
  "title": "list_eventsArguments"
}

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 country's block being its own {total, by_type, by_bundesland}. Only AT exposes event statistics today; DE is reported in notices as not yet available (never as zero). For the individual changes use list_events.

Parameters7

since	any	optional
until	any	optional
bundesland	any	optional
nace_section	any	optional
nace_division	any	optional
legal_form	any	optional
country	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Since"
    },
    "until": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Until"
    },
    "bundesland": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Bundesland"
    },
    "nace_section": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Nace Section"
    },
    "nace_division": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Nace Division"
    },
    "legal_form": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Legal Form"
    },
    "country": {
      "default": "all",
      "title": "Country",
      "type": "string"
    }
  },
  "title": "get_event_statsArguments"
}

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 that window - never another user's data and never the email behind the key. One meter spans AT and DE, since the facade is the single billing point. Use it to check your consumption against the plan's rate limits.

Parameters1

window

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "window": {
      "default": "today",
      "title": "Window",
      "type": "string"
    }
  },
  "title": "get_my_usageArguments"
}

README.md14 KBView on GitHub

agentic-firmenbuch

Austria's entire company register, queryable by AI agents in plain language. Official master data, annual accounts and key ratios for every firm – served over MCP, answered on real numbers instead of hallucinations.

Try the playground · Get a free key · Quickstart ↓

A live, automated data product over the Austrian Firmenbuch (free EU HVD / High Value Datasets), served through a multi-tenant MCP server. A deterministic Azure pipeline pulls the published Jahresabschluss (annual financial statement) filings from the official register, parses them, consolidates per company, computes ratios/growth/trends, and serves the result to MCP clients. The whole register holds ~640k legal entities; the served slice is currently ~341k and grows as the backfill progresses. Version 1 = facts + clean derivations only (no scoring, no third-party enrichment, no NACE, no AI summaries).

Also available: Germany and the wider DACH region. Alongside this Austrian product, a unified agentic-register endpoint serves both the Austrian Firmenbuch and the German Handelsregister / Unternehmensregister over a single MCP. It is listed in the official MCP registry as io.github.jkbngb/handelsregister (spec: handelsregister.server.json) and reachable at https://register.agentic-firmenbuch.at/mcp with the same free API key. A search returns matches from both countries, tagged by country (AT / DE).

Quickstart

Use the hosted service – query official Firmenbuch data from an MCP client that accepts an HTTP header key (Claude Code, VS Code with GitHub Copilot, Cursor, …):

Get a free API key at agentic-firmenbuch.at – just a verified email.
Add the server. Claude Code (terminal), one line:
bash
```
claude mcp add --scope user --transport http agentic-firmenbuch https://mcp.agentic-firmenbuch.at/mcp --header "X-API-Key: <your-key>"
```
GitHub Copilot / VS Code: code --add-mcp "{\"name\":\"agentic-firmenbuch\",\"type\":\"http\",\"url\":\"https://mcp.agentic-firmenbuch.at/mcp\",\"headers\":{\"X-API-Key\":\"<your-key>\"}}". Any other HTTP-MCP-Header client: URL https://mcp.agentic-firmenbuch.at/mcp, header X-API-Key: <your-key>.
Ask in natural language, e.g. "Aktive GmbHs in Oberösterreich mit Bilanzsumme über 5 Mio. €, sortiert nach Umsatz." The agent calls search_companies / get_company_details and answers with official data – no SDK required.

Claude Cowork & claude.ai (sandboxed clients) don't take the API-key header – they connect via Settings → Connectors → Add custom connector with the URL https://mcp.agentic-firmenbuch.at/mcp and a one-time email login (OAuth, no key). Step-by-step with screenshots: agentic-firmenbuch.at/cowork.html.

Prefer to try before signing up? Use the playground.

Or run the pipeline yourself – clone, uv sync, uv run pytest (offline, no Azure). See Develop.

Available MCP tools

Tool	Purpose
`search_companies`	Filter / rank Austrian companies by region, size, balance-sheet total, equity ratio, revenue, growth profile, management age, last filing year, status. Returns a compact result card per match.
`get_company_details`	Full served profile of one company: identity, location, founding/filing years, size class, multi-year balance sheet + P&L, 13 computed ratios, growth, management, list of filings.
`get_full_record`	Superset of `get_company_details`: full 317-position UGB taxonomy, passthrough unknown codes, completeness, GuV-years, signatories history, derivations registry.
`get_company_history`	Filing-by-filing time series of every reported position for one company.
`find_peers`	K-nearest peer set for a company within its size class / region.
`get_cohort_summary`	Aggregate statistics (counts, percentiles, distributions) for a filtered cohort.
`get_coverage`	Per-Bundesland / per-Rechtsform / per-size-class coverage statistics for the served dataset.
`list_sectors`	Available legal-form (`Rechtsform`) and Bundesland codes for use in filters.
`describe_fields`	Self-describing field dictionary with type + null-rules + EBIT/EBITDA definition.
`get_document`	Fetch the URL/blob key for an original filed annual statement (XML or PDF).

All tools return a processed derivative of official Austrian Firmenbuch data (source: BMJ – Justiz, CC BY 4.0). Concretely: we ingest the published filings from the register, parse and consolidate them, compute ratios, and serve that from our own database — no web scraping, no LLM-generated summaries, no third-party data mixed in (V1). Every response carries provenance.data_version + built_at and names the original source, so the agent can attribute it correctly; for the authoritative record, the official Firmenbuch always governs.

Currently served: ~341,000 active legal entities across all Rechtsformen (GmbH, AG, KG, OG, EU, Genossenschaft, Privatstiftung, SE …). The full register has ~640,000 entities; the gap is companies without a published Jahresabschluss plus inactive/deleted entries, which are added step by step.

Documentation

Full index with the versioning convention (shipped _v1 specs vs. the forward ROADMAP.md + V2 design spec): docs/README.md. The headline documents:

Doc	What it is
docs/pipeline-step-samples.md	File format + golden sample for every pipeline stage.
docs/FIELD_REFERENCE.md	Served field dictionary – every field each MCP tool returns, with type + null rules. Public page: felder.html.
ROADMAP.md	Forward plan – status/priorities and the V2 direction (banks/insurers, GISA, Ediktsdatei).
docs/appendix_position_mapping.json	Full 317-entry canonical position taxonomy → copied into `products/agentic-firmenbuch/packages/core_at/…/mapping/`.
docs/reference/	Official source material (API reference, JAb 4.0 XSDs/Excel).

Monorepo layout (`agentic-first`)

This repository is the agentic-first monorepo umbrella. It separates source-agnostic shared code from per-source products, so another source-specific product can be added without touching the Austrian pipeline:

code

agentic-first/                       (this repo)
├── packages/                        SHARED — source-agnostic, zero Firmenbuch/UGB knowledge
│   ├── core/    (fbl_core)          lineage/meta + metric contracts, config, storage clients
│   └── auth/    (fbl_auth)          signup, token issue/validate, metering, 00_accounts
└── products/
    └── agentic-firmenbuch/           AUSTRIA product (live) — README below
        ├── packages/
        │   ├── core_at/  (fbl_core_at)   UGB taxonomy, Firmenbuch domain models, ÖNACE, FI dirs
        │   ├── firmenbuch_client, 99_registry, 90_ingest, 70_parse,
        │   │   50_consolidate, 30_derive, 10_present, mcp_server, orchestration
        │   └── …
        └── tests/                   AT integration tests + golden fixtures

Additional source-specific products are added in their own separate repositories that consume packages/{core,auth} as a dependency (they are not scaffolded here). The precise 1:1 / adapt / product-local reuse boundary is the reuse table (Appendix R) of the technical spec, and the generic recipe is in docs/monorepo/ADDING_A_PRODUCT.md.

Product READMEs: agentic-firmenbuch · shared core · auth

Pipeline (numbered layers, `90 → 10`)

code

99_registry (foundation: all companies)  →  90_raw (Blob)  →  70_parsed (Blob)  →  50_consolidated  →  30_derived  →  10_presentation  →  MCP
                                                                        (Cosmos)            (Cosmos)        (Cosmos)
   side: 00_accounts (MCP signup) · 00_directories (register-based FI flag, OeNB)   reserved for v2: 40_enriched, 20_scored

90_raw is the immutable source of truth (every downloaded XML/PDF, kept forever). 70_parsed is a write-through cache of the per-filing ParsedFiling JSON – always re-derivable from raw, so safe to drop/rebuild; it exists so a reprocess (re-consolidate/derive after a logic change) skips re-parsing all filings, and so the lineage inputs[] in each consolidated doc resolve to a real parsed document. 50/30/10 are the queryable Cosmos layers; 10_presentation is what the MCP serves.

LAYER_MAP – which code owns which layer

Each pipeline-stage package directory is prefixed with its layer number so the owner of every data layer is obvious. (Python module names can't start with a digit, so the importable package keeps its fbl_* name; the number is also exposed as a LAYER constant in each stage package.)

All AT stage packages live under products/agentic-firmenbuch/packages/ (abbreviated …/ below).

Layer	Package (dir)	import	Store / container	Pydantic model	Sample
`99_registry`	`…/99_registry`	`fbl_registry`	Cosmos `99_registry`	`RegistryDoc`	§15a.0 doc
`90_raw`	`…/90_ingest`	`fbl_ingest`	Blob `90-raw`	raw `Meta` + manifest	Stage 0
`70_parsed`	`…/70_parse`	`fbl_parse`	Blob `70-parsed`	`ParsedFiling`	Stage 1
`50_consolidated`	`…/50_consolidate`	`fbl_consolidate`	Cosmos `50_consolidated`	`ConsolidatedCompany`	Stage 2
`30_derived`	`…/30_derive`	`fbl_derive`	Cosmos `30_derived`	`DerivedCompany`	Stage 3
`10_presentation`	`…/10_present`	`fbl_present`	Cosmos `10_presentation`	`PresentedCompany`	Stage 4

Un-numbered. Shared (in packages/): core (fbl_core, source-agnostic lineage/meta + metric contracts, config, storage) and auth (fbl_auth, 00_accounts). AT-specific (in products/agentic-firmenbuch/packages/): core_at (fbl_core_at, UGB taxonomy + Firmenbuch domain models + ÖNACE + FI directories), firmenbuch_client (fbl_firmenbuch_client, HVD SOAP adapter), orchestration (fbl_orchestration, the --mode Job entrypoint), mcp_server (fbl_mcp_server, serving). Plus products/agentic-firmenbuch/tests/ (fixtures), docs/ (incl. API probe findings).

Build status – Version 1 complete ✅

All ten §15 build stages are implemented, each committed in order, each with a passing Definition of Done. ruff + mypy --strict + pytest (with an 80% coverage gate) are green in CI. The HVD API was live-probed (§16 resolved) and the full chain raw→present was verified on live data end-to-end.

Stage 10: an auth-restricted coverage tool (XML vs PDF-only vs none, by format/status – §11) and GitHub Actions CI (uv sync → ruff → ruff format → mypy --strict → pytest with an 80% coverage gate, plus a Bicep-compile job).

What's left to operate (not code): provision Azure (infra/setup.sh, billable), push the FIRMENBUCH_API_KEY to Key Vault, build/push images, then run the Initial Load (sync-registry → backfill-ingest → backfill-process) and enable the daily cron.

Develop

bash

uv sync                            # create the workspace venv
uv run pytest                      # all fixture/unit/integration tests (offline)
uv run mypy packages products      # strict types (shared + products)
uv run ruff check packages products  # lint

True end-to-end (live): a separate, env-flag-guarded test runs a few real FNRs through every layer (API → 90_raw → … → 10_presentation → MCP). Skipped by default.

bash

FBL_E2E=1 uv run pytest products/agentic-firmenbuch/tests/e2e -q  # needs FIRMENBUCH_API_KEY

See products/agentic-firmenbuch/tests/e2e/. It uses in-memory stores + a tiny real pull – no Azure, no full backfill (deployment is manual after review).

License & data

Licensed under the MIT License (see LICENSE).

The data originates from the Austrian Firmenbuch (BMJ – Justiz), an EU High Value Dataset licensed under CC BY 4.0. Any redistribution of the data must keep the attribution "Quelle: Österreichisches Firmenbuch / BMJ – Justiz (CC BY 4.0)" (see NOTICE).

Disclaimer – no warranty, use at your own risk

This software and any data it produces are provided "AS IS", WITHOUT WARRANTY OF ANY KIND, express or implied (see the MIT License). The processed data is derived automatically from the public Firmenbuch and is provided without any guarantee of correctness, completeness, timeliness, or fitness for a particular purpose. It is not legal, tax, or financial advice and does not replace an official Firmenbuch extract – the official register always prevails.

Use of this software and the data is entirely at your own risk. To the maximum extent permitted by law, the authors and copyright holders accept no liability for any direct, indirect, incidental, or consequential damages arising from its use. You are responsible for complying with the CC BY 4.0 attribution requirement and all applicable data-protection, competition, and copyright law when using or redistributing the data.

Install

Tools (11)

pingget_coveragedescribe_fieldssearch_companiesget_company_detailsexport_companies_csvfind_peerssearch_person

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://register.agentic-firmenbuch.at/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "handelsregister": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://register.agentic-firmenbuch.at/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.jkbngb/handelsregister (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

ping

get_coverage

describe_fields

search_companies

get_company_details

export_companies_csv

find_peers

search_person

list_events

get_event_stats

get_my_usage

agentic-firmenbuch

Quickstart

Available MCP tools

Documentation

Monorepo layout (agentic-first)

Pipeline (numbered layers, 90 → 10)

LAYER_MAP – which code owns which layer

Build status – Version 1 complete ✅

Develop

License & data

Disclaimer – no warranty, use at your own risk

Install

Remote endpoint

Related servers

Monorepo layout (`agentic-first`)

Pipeline (numbered layers, `90 → 10`)