We released an official Model Context Protocol (MCP) server for firmafind. You can now connect AI coding tools directly to the Austrian company register (Firmenbuch) and insolvency edicts (Edikte).

With the MCP server, AI assistants can look up company addresses, retrieve managing directors, check financial filings, and inspect register changes as part of your development workflow.

Open source repository and npm package

The server code is published as part of our open source repository on GitHub at paullotz/firmafind-tools.

You can run the package directly without local installation using npx:

FIRMAFIND_API_KEY="your_api_key" npx -y @firmafind/mcp-server

The package is published on npm as @firmafind/mcp-server.

Setting up your client

OpenCode

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

{
  "mcp": {
    "firmafind": {
      "type": "local",
      "command": ["npx", "-y", "@firmafind/mcp-server"],
      "enabled": true,
      "env": {
        "FIRMAFIND_API_KEY": "your_api_key",
        "FIRMAFIND_BASE_URL": "https://firmafind.at"
      }
    }
  }
}

Verify that OpenCode recognizes the server:

opencode mcp list

Claude Desktop

Add the server configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "firmafind": {
      "command": "npx",
      "args": ["-y", "@firmafind/mcp-server"],
      "env": {
        "FIRMAFIND_API_KEY": "your_api_key"
      }
    }
  }
}

Cursor and VS Code

In your assistant settings under MCP Servers, configure a new stdio connection:

• Command: npx -y @firmafind/mcp-server
• Environment variable: FIRMAFIND_API_KEY=your_api_key

Available tools

The server provides 7 functions for your AI agent:

1. search_companies: Search Austrian and Czech company records by name or legal form.
2. get_company_details: Fetch complete registration records by Firmenbuchnummer (fnr).
3. get_company_changes: Query historical changes filed in the company register within a date range.
4. list_company_documents: List submitted annual reports and balance sheets.
5. download_company_document: Download document contents by key.
6. list_edikte: Search public edicts for insolvency notices and balance sheet filings.
7. get_edict_details: Inspect publication details by type and ID.

If you have suggestions or contributions for additional tool definitions, check out the source code on GitHub or contact us at [email protected].