MCP connector
Ironhat runs a hosted MCP server — nothing to install. Point any MCP-capable client at the endpoint with your API key and your agent gets official EU company data as native tools.
Endpoint & auth
| Endpoint | https://ironhathq.com/api/mcp |
| Transport | Streamable HTTP |
| Auth (header) | Authorization: Bearer ih_live_… |
| Auth (URL) | …/api/mcp?key=ih_live_… — for clients that can't set headers. Treat the URL as a secret. |
Connect by client
claude.ai · Claude Desktop · Cowork
Settings → Connectors → Add custom connector → name it Ironhat → paste:
Connector URL
https://ironhathq.com/api/mcp?key=YOUR_API_KEY
Claude Code
Terminal
claude mcp add --transport http ironhat https://ironhathq.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
Codex / other stdio-only clients
Bridge with mcp-remote in ~/.codex/config.toml:
config.toml
[mcp_servers.ironhat] command = "npx" args = ["-y", "mcp-remote", "https://ironhathq.com/api/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
Tools
Responses are readable markdown — your agent can present them directly.
| Tool | What it does |
|---|---|
company_briefing | Start here. Name or register number in → profile, balance-sheet table with YoY, filings on record, next-step options. One call. |
search_company | Find companies by name in the official register. |
get_company | Registry profile for one company by register number. |
get_financials | Official balance-sheet figures for up to 5 fiscal years. |
list_filings | Every annual account on file, with filing dates. |
check_vat | Validate any EU VAT ID (official VIES service). |
Prompts that work well
- “Give me a company briefing on Red Bull in Austria.”
- “How did Zitronenblau GmbH's equity develop over the last two years?”
- “Is VAT ID ATU80966304 valid, and who is it registered to?”
- “We're onboarding a Vienna supplier — check them out before we sign.”
Limits
Free tier: 500 requests / month per account, shared between MCP and REST. Over the limit the server returns a clear message; usage resets on the 1st. See Pricing & limits.