firmafind
Back to the overview

Connecting AI coding agents to company data with Model Context Protocol

3 min

The firmafind MCP server is now hosted. You can connect your AI coding tools to the Austrian company register (Firmenbuch) and Edikte without installing a local package.

The hosted server runs at https://firmafind.at/api/mcp with Streamable HTTP. You send your API key in the header and the tools are ready to use.

Hosted server and who can use it

MCP access requires a paid plan or an active trial. Starter, Pro and Business all include it. If you are on the free plan you can use the REST API, but MCP requests return a 402 error with a link to upgrade. You can check your plan and upgrade at https://firmafind.at/dashboard/keys.

Every tool call uses credits the same way as the REST API. Regular lookups cost 1 credit. Document downloads cost 10 credits. If your balance is low you get a clear error with the remaining credits.

The firmafind skill

We also publish a single agent skill for firmafind. It tells your agent when to use the hosted MCP server and when to fall back to REST, how to handle fnr numbers like 123456x, and how to format company, document and edikt queries.

Install it with:

npx skills add firmafind

This adds .agents/skills/firmafind/SKILL.md to your project. OpenCode, Claude Code and other skills-aware agents pick it up automatically. You do not need to copy the MCP config by hand if your client supports skills.

If you prefer to configure the MCP server manually, use the hosted URL below.

Connecting your client to the hosted server

All three setups use the same values:

  • URL: https://firmafind.at/api/mcp
  • Header: x-api-key: YOUR_API_KEY (or Authorization: Bearer YOUR_API_KEY)
  • Transport: Streamable HTTP

OpenCode

Add this to opencode.json in your project root or in ~/.config/opencode/opencode.json:

{
	"mcp": {
		"firmafind": {
			"type": "remote",
			"url": "https://firmafind.at/api/mcp",
			"headers": {
				"x-api-key": "your_api_key"
			}
		}
	}
}

Check the connection:

opencode mcp list

Claude Desktop

Add this to your claude_desktop_config.json:

{
	"mcpServers": {
		"firmafind": {
			"command": "npx",
			"args": [
				"-y",
				"mcp-remote",
				"https://firmafind.at/api/mcp",
				"--header",
				"x-api-key: your_api_key"
			]
		}
	}
}

Newer Claude Desktop versions also support a direct URL entry. In that case use https://firmafind.at/api/mcp and add the x-api-key header in the settings UI.

Cursor and VS Code

In Cursor or VS Code, go to MCP Servers and add a remote Streamable HTTP server:

  • URL: https://firmafind.at/api/mcp
  • Header: x-api-key: your_api_key

Available tools

The hosted server exposes 8 tools:

  1. search_austrian_company: search Austrian companies by name, legal form or court.
  2. get_company_details: full register extract for a Firmenbuchnummer (fnr), with address, capital, directors and shareholders.
  3. get_company_changes: register changes and new formations in a date range.
  4. list_company_documents: list annual reports and balance sheets that are available.
  5. download_company_document: download the filing and a parsed JSON version of the annual report XML when available.
  6. list_edikte: search public edicts for insolvency notices.
  7. get_edikt_details: details for an edikt by type and ID.
  8. screen_eu_sanctions: screen a name or company against the EU Consolidated Sanctions List.

Need help

If you have questions or want a new tool, open an issue on GitHub or write to [email protected]. We read every message.