# Ironhat

> Agent-native company-registry infrastructure for the EU. Live today: Austrian company
> search, the official document index, downloadable annual accounts (PDF + structured XML),
> parsed financial statements, and EU-wide VAT validation — over a REST API and a hosted
> MCP server. Official primary sources only, with the license class on every response.

## Status (14 Jul 2026) — live and callable

- REST API: live at https://ironhathq.com/api/v1
- MCP server: live at https://ironhathq.com/api/mcp (streamable HTTP)
- Auth: API key — sign up free at https://ironhathq.com/login (SSO or email), create a key
  in the dashboard. Send it as `x-api-key: <key>` or `Authorization: Bearer <key>`.
- Free tier: 500 requests per month per account.
- Coverage: Austria (Firmenbuch — official, CC BY 4.0 open data) + EU-wide VAT (VIES).
  Every response carries `source` and `licenseClass`.

## MCP (recommended for agents)

Endpoint: `https://ironhathq.com/api/mcp` · Transport: streamable HTTP · Auth: `Authorization: Bearer <api key>`
Clients that cannot set headers (claude.ai / Claude Desktop custom connectors): put the key
in the URL instead — `https://ironhathq.com/api/mcp?key=<api key>` (treat that URL as a secret).

Tools (responses are readable markdown — present them directly):
- `company_briefing(country, company)` — START HERE: name or registration number in, full
  briefing out (profile + balance-sheet table with YoY + documents on file). One call.
- `search_company(country, query, limit?)` — search the register by name (AT live).
- `get_company(country, id)` — registry profile by registration number (e.g. FN `598134i`).
- `list_filings(country, id)` — official document index: every annual account on file, with
  balance-sheet date, filing date, format (pdf/xml) and a download key.
- `get_financials(country, id, periods?)` — structured balance-sheet figures (total assets,
  equity, liabilities, cash, …) parsed from the official annual-account XML, up to 5 fiscal years.
- `check_vat(vatId)` — validate any EU VAT id (VIES).

## REST API

Base: `https://ironhathq.com/api/v1` · Header: `x-api-key: <key>`

- `GET /search?country=AT&q=<name>` — company search.
- `GET /company/AT/{fn}` — company profile.
- `GET /company/AT/{fn}/filings` — document index (annual accounts, PDF + XML).
- `GET /company/AT/{fn}/filings/{key}` — download the official document.
- `GET /company/AT/{fn}/financials?periods=2` — parsed balance-sheet figures.
- `GET /vat?id=ATU12345678` — EU VAT validation.

Errors: `401` invalid/missing key · `429` monthly limit reached · `400` bad request.

## Coming next (not yet callable — this file only lists what is live)

- More countries on free official registers (UK, Denmark, Norway, Czechia, Finland …).
- Ownership / org-charts, certified extracts, apostille + legalization, certified translation
  as paid services with in-flow payment links.

## Human documentation

- https://ironhathq.com/docs (quickstart, MCP connector, REST reference, pricing)

## Contact

- https://ironhathq.com · Dashboard: https://ironhathq.com/dashboard