@aiwerk/mcp-server-swiss-company
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SWISS_COMPANY_TIMEOUT_MS | No | Timeout per request. | 20000 |
| SWISS_COMPANY_ENABLE_ZEFIX_WEB_API | No | Set to '1' to also use the API behind the zefix.ch search page. | off |
| SWISS_COMPANY_MAX_REQUESTS_PER_CALL | No | Request budget per tool call, at most 200. A call that would need more fails and asks for a narrower question. | 40 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ch_company_searchA | Find Swiss companies in the commercial register by part of their registered name, or by a word in their statutory purpose (match="purpose", needs a canton). Returns candidates with UID, legal form, address and purpose. The name match is a substring of the registered name, so a name from a website or Google Maps may need a shorter, distinctive part. When several candidates come back, confirm the right one by address before using its UID. |
| ch_company_profileA | What the official registers hold about one company, by UID: name and translations, legal form, commercial register and UID register status, legal address, statutory purpose, VAT registration (status, since when, VAT number) and identifiers. With the Zefix web API enabled it adds seat, former names, auditors, the companies it audits, branches and takeovers. |
| ch_company_historyA | The company's own commercial register publications from the Swiss Official Gazette of Commerce (SHAB), newest first: registration, changes to officers, name, seat, address, purpose or capital, liquidation, bankruptcy and deletion, each with the full publication text and the list of changed fields. Publications in which the company only appears as auditor or liquidator of another company are left out; see ch_company_mentions for those. |
| ch_company_mentionsA | Gazette publications about OTHER companies that name this one, for example as auditor, liquidator or merger partner, with a text snippet and a role hint. Shows which companies a fiduciary or audit firm works for. |
| ch_register_publicationsA | New commercial register entries in one canton over a date window of up to 31 days, newest first, from the Swiss Official Gazette of Commerce. type="mutation" or "deletion" lists changes or deletions instead. details=true adds name, UID, address, capital and purpose per row at one request each (at most 25 rows). Page through larger windows with page. |
| ch_validate_uidA | Check a Swiss UID or VAT number: the check digit locally, then (unless lookup=false) whether the UID register knows it, its status, and whether the company is currently VAT registered. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a distinct operation: search, history, mentions, profile, register feed, and UID validation. Overlap between search and profile is clarified by UID-based lookup vs name-based candidate search, and history vs mentions explicitly separates own vs third-party publications.
All tools share the ch_ prefix and snake_case, but verb placement varies: ch_company_search and ch_validate_uid are verb-focused while ch_company_history, ch_company_mentions, ch_company_profile, and ch_register_publications are noun-focused. This is mostly predictable and readable, with only minor stylistic inconsistency.
Six tools cover search, detail, validation, and publication querying without redundancy. This is well within the ideal range and each tool earns its place for a focused Swiss company register server.
The set provides a complete lifecycle for company data: find candidates, validate identifiers, view the official profile, and inspect both own and third-party publications. There are no obvious dead ends, and references to related tools fill any potential gaps.