Zefix Search

by zahhar

474 downloads

Not rated

GitHub

About

⚠️ Unofficial MCP server for zefix.ch – Switzerland Central Business Name Index.

Details

Author: zahhar
Downloads: 474
Categories: Search, Other, Security

- Search Swiss companies by name or UID (CHE-nnn.nnn.nnn)
- Filter by canton, legal form, location, and former names
- Get full company details including purpose, address, capital, and auditors
- Supports phonetic and substring/wildcard search
- Results returned in Markdown with detail level based on result count
- Capped at 100 results per query

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Zefix Search

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

From the repository

Install the .mcpb file on Claude Desktop or add the npx command to your MCP host config. Once configured, invoke the get_companies tool with parameters such as name_or_uid, cantons, legalForms, exactSearch, and phoneticSearch. The server runs over stdio and requires no authentication.

`get_companies`

Returns semi-structured markdown text including legal names, address, business identifiers, names of legal representatives, registered capital, mergers and acquisitions, auditor, purpose, former names, and the history of changes for the found company.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "zefix search": {
            "zefix": {
                "command": "npx",
                "args": [
                    "-y",
                    "zefix-mcp-unofficial"
                ]
            }
        }
    }
}

McpServers

{
    "zefix": {
        "command": "npx",
        "args": [
            "-y",
            "zefix-mcp-unofficial"
        ]
    }
}

Zefix MCP

> ⚠️ Unofficial MCP server for zefix.ch – Switzerland Central Business Name Index.
\
This project is not affiliated with or endorsed by the Federal Department of Justice and Police (FDJP) - Federal Office of Justice (FOJ) who are developing and maintaining zefix.ch.

Features and Use-cases

- Allows your AI-assistant to search for companies incorporated in Switzerland by their name or UID (CHE-nnn.nnn.nnn) with optional filters by canton of incorporation, legal form, location, previous names, etc. (mimics all filters in Zefix GUI).
- Equips your AI-assistant with full company details available in Zefix (business names and identifiers, purpose, address, auditors, change history, capital, names of legal representatives, merges & acquisitions) to build further automation workflows or answer business-specific questions.

Sample questions MCP can answer

Company lookup
- "Find if Google has a legal body in Switzerland and show me their registered address."
- "Was ist der vollständige rechtliche Name und die UID des Unternehmens, das als Migros bekannt ist?"
- "Recherche le CHE-169.865.482 et dis-moi tout ce que tu sais à son sujet."

Filtering & discovery
- "List all active Treuhand companies headquartered in canton Schaffhausen."
- "Finde Einzelunternehmen im Bereich Malerei, die irgendwo in der Grossregion Zürich eingetragen sind."
- "Dresse une liste des adresses et des représentants légaux de toutes les banques en Romandie."

History & changes
- "What is the new name of the company formerly known as 'SwissAir'?"
- "Zeig mir die vollständige Namens- und Eigentümergeschichte von Credit Suisse."
- "Y a-t-il des entreprises qui ont repris ou fusionné avec UBS AG ?"

Due diligence & research
- "Who is listed as auditor for Zurich Insurance Group?"
- "Ich stehe kurz vor der Unterzeichnung eines Vertrags mit Hans Müller als Vertreter von Lindt & Sprüngli – ist er dazu bevollmächtigt?"
- "Vérifie que Bollinger est une entreprise active spécialisée dans la plomberie, et dis-moi depuis combien de temps elle existe et quel est son capital enregistré."

Requirements

- MCP host application (Claude, LLM Studio, VSCode+GHCP/Cline, Cursor, Dive, LibreChat, DeepChat, Chainlit etc.)
- LLM that supports Tool calling (GPT-4.1+ Claude Sonnet/Opus, Gemini, Llama 3.1+, Qwen3.5, etc.)
- (optional) Node.js 24+ (for development or local run without npx)

Installation

As a Claude Desktop Extension (easiest)

1. Go to the Releases page and download the latest zefix.mcpb file.
2. Double-click it — Claude Desktop opens automatically.
3. Click Install.

Restart Claude Desktop if you do not see zefix tool in the list of available tools.

Via npx (recommended for all other MCP hosts)

Add to your MCP host config:

{
  "mcpServers": {
    "zefix": {
      "command": "npx",
      "args": ["-y", "zefix-mcp-unofficial"]
    }
  }
}

npx downloads, caches, and runs the package automatically. No local install required.

From source

git clone https://github.com/your-org/zefix-mcp-unofficial.git
cd zefix-mcp-unofficial
npm install
npm run build

Than add this section to config file of your MCP host application (syntax may vary, check documentation for your MCP host app):

{
  "mcpServers": {
    "zefix": {
      "command": "node",
      "args": ["/absolute/path/to/zefix-mcp-unofficial/dist/index.js"]
    }
  }
}

Tool reference

`get_companies`

Search the Zefix registry. All parameters except name_or_uid are optional.

| Parameter | Type | Description |
|---|---|---|
| name_or_uid | string | Company name or UID (CHE-nnn.nnn.nnn). |
| language_key | string | Response language: en, de, fr, it. Default: en. |
| cantons | string[] | Filter by canton codes, e.g. ["ZH", "BE"]. |
| locations | string[] | Filter by legal seat town names, e.g. ["Zurich", "Bern"]. |
| legalForms | string[] | Filter by legal form, e.g. ["AG", "GmbH"]. |
| exactSearch | boolean | Search from start of name (default: true). Set false for substring/wildcard (*) search. |
| phoneticSearch | boolean | Enable phonetic/fuzzy matching. |
| includeDeleted | boolean | Include deregistered companies (default: false). |
| includeFormerNames | boolean | Also search former company names (default: false). |

Tips:
- If you know the UID, use it — it will return the most accurate full-detail result.
- If exactSearch: true returns no results, retry with exactSearch: false and phoneticSearch: true combination.
- Results are returned in Markdown, with detail level depending on amount of found companies:
- 1 result → full details;
- 2–10 → detailed summaries, but without full history and list of legal representatives;
- 11+ → name/UID/status list only.
- Results are capped at 100 items.
- The server communicates over stdio (MCP standard transport) — it won't print anything to the terminal when run directly.
- When MCP server queries Zefix REST API at https://www.zefix.ch/ZefixREST/api/v1/ (public, no authentication required) it submits User-Agent: zefix-mcp-unofficial for transparency. You may want to change uf if using this MCP as part of your larger solution.

---

Development and Debugging

Build

```bash
npm run build

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_companies

Claude Desktop / Cursor

McpServers

Zefix MCP

Features and Use-cases

Sample questions MCP can answer

Requirements

Installation

As a Claude Desktop Extension (easiest)

Via npx (recommended for all other MCP hosts)

From source

Tool reference

get_companies

Development and Debugging

Build

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

Reactive Resume

`get_companies`

`get_companies`