Set up connection

0 Prerequisite

• An API key from the confirmation email. Don't have one yet? Request one free here.
• Server address: https://mcp.agentic-firmenbuch.at/mcp

1 Claude Code Terminal

For Claude Code only (the terminal tool). For the desktop app, use step 2 instead. One command, paste as a single line (identical on macOS, Linux, Windows/PowerShell):

Open a terminal: macOS → ⌘ + Space, type "Terminal" · Windows → Start menu, "PowerShell" · Linux → your terminal app.

claude mcp add --scope user --transport http agentic-firmenbuch https://mcp.agentic-firmenbuch.at/mcp --header "X-API-Key: YOUR_API_KEY"

Test the connection: open a new chat and ask, for example: "Are you connected to the Agentic-Firmenbuch server, and which tools does it expose?" – if the agent lists the Firmenbuch tools (search companies, metrics, history, etc.), the connection is live.

2 Other MCP clients VS Code · Cursor · …

Any MCP client that supports remote HTTP servers with header authentication – VS Code (GitHub Copilot), Cursor, and others – connects with the same two details:

• Address: https://mcp.agentic-firmenbuch.at/mcp · type http
• Header: X-API-Key: YOUR_API_KEY

The exact steps are in each tool's official docs: VS Code (MCP) · Cursor (MCP). Usually as an mcp.json entry:

{
  "mcpServers": {
    "agentic-firmenbuch": {
      "type": "http",
      "url": "https://mcp.agentic-firmenbuch.at/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Note: these clients are MCP-compliant; the exact workflow follows each vendor's docs.

3 Claude Cowork & desktop app one click · no key

For the Claude desktop app (Chat & Cowork tabs) no API key is needed – the connection uses a connector with a one-time email sign-in. Illustrated step-by-step guide (Settings → Connectors → connector with the address https://mcp.agentic-firmenbuch.at/mcp):

4 Get started

Sample questions you can ask right away:

• "Show me active GmbHs in Styria with total assets above 5 million euros."
• "Which companies have been growing for years and have a high equity ratio?"
• "Get me the balance-sheet metrics and the latest annual report for company XY."

To try it without setup: Playground and Data fields.

5 Available tools (MCP tools)

The server exposes these tools to the AI tool. The agent picks them based on the question – you don't need to call them directly.

• search_companies – filter companies (region, legal form, size class, total assets, equity ratio, revenue, employees, growth, managing-director age) → list of compact result cards.
• get_company_details – curated company profile for a Firmenbuch number.
• get_company_history – multi-year time series per metric (total assets, equity ratio, etc.).
• get_full_record – full dataset including all balance-sheet positions with their official UGB codes.
• get_document – reference/link to the original annual report.
• list_sectors – industry/size overviews with counts.
• get_cohort_summary – aggregate metrics for a cohort (e.g. all GmbHs in Styria).
• find_peers – comparable companies by size class and total assets.

6 What data is delivered

Per company, structured and with provenance:

• Identity – company name, Firmenbuch number, legal form, status (active/historical/deleted).
• Location – federal state, registered seat, Firmenbuch court.
• Size – size class (micro/small/medium/large), total-assets band.
• Financials – balance-sheet and (where published) P&L values, multi-year; each position with its official UGB code (e.g. "§ 224 Abs 2 A II").
• Metrics – equity ratio, leverage, coverage ratios, EBIT/EBITDA, margins, ROE/ROA – computed, with history.
• Growth – profile (shrinking/stable/growing/fast-growing) + rates.
• Employees – where published.
• Management – name, role, type of representation, plus age and year of birth (year only — no day/month, GDPR).
• Original documents & provenance – list of annual reports + source and license (CC BY 4.0).

7 Data source, freshness & privacy

• Source – Austrian Firmenbuch / JustizOnline (BMJ – Ministry of Justice), used under CC BY 4.0. Data without warranty.
• Freshness – continuously updated via the official change feeds.
• Privacy – no personal names are delivered; for persons, only age/year of birth (year), role, and type of representation.

8 Fair use & managing your key

• Free with a generous rate limit per key; more volume on request.
• Lost or compromised key? Request a new key – the old one is invalidated immediately.
• Treat the key like a password and don't share it (Terms of Service).