@aiwerk/mcp-server-swiss-company
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@aiwerk/mcp-server-swiss-company Is Swisscom AG still active in the commercial register?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@aiwerk/mcp-server-swiss-company
MCP server for Swiss company data from official public sources: the commercial register (Zefix open data via LINDAS), the UID register of the Federal Statistical Office, and the Swiss Official Gazette of Commerce (SHAB).
It answers questions about one company at a time: who is this, is it active, is it VAT registered, what changed in the register and when, which companies does this fiduciary act for, and which companies were newly registered in a canton this week. It never downloads a source in bulk. Every tool call runs under a hard request budget.
Install
npx -y @aiwerk/mcp-server-swiss-companyOr add it to your MCP client configuration:
{
"mcpServers": {
"swiss-company": {
"command": "npx",
"args": ["-y", "@aiwerk/mcp-server-swiss-company"]
}
}
}No API key is needed.
Related MCP server: mcp-server-zefix
Tools
Tool | What it answers | Requests |
| Companies whose registered name contains a text, or whose statutory purpose contains a word (per canton). Candidates with UID, legal form, address and purpose. | 1 |
| One company by UID: name and translations, legal form, commercial register and UID register status, legal address, purpose, VAT registration (status, since when, VAT number), identifiers. | 2 |
| The company's own register publications, newest first: registration, changes to officers, name, seat, address, purpose, capital, liquidation, bankruptcy, deletion. Full text plus the list of changed fields. | 2 + one per publication |
| Publications about other companies that name this one, e.g. as auditor, liquidator or merger partner, with a text snippet and a role hint. | 2 + one per publication |
| New registrations, changes or deletions in one canton over up to 31 days. With | 1, or 1 + one per row |
| Check digit of a UID or VAT number, and whether the UID register knows it and lists it as VAT registered. | 0 or 1 |
Start with ch_company_search. The name in the commercial register often differs from the one on a website, a letterhead or Google Maps (hyphens, "Dr." spacing, a different legal form), so search for a short, distinctive part of it and confirm the right candidate by address before using its UID.
Configuration
Variable | Default | Description |
|
| Request budget per tool call, at most 200. A call that would need more fails and asks for a narrower question. |
|
| Timeout per request. |
| off | Set to |
Sources and their terms
Source | Used for | Terms relevant here |
LINDAS Zefix dataset | Search, purpose, municipality | Open government data: "Open use. Must provide the source." |
UID register public services | Status, legal address, VAT registration | Free. The public services allow 20 requests per minute per caller and block temporarily when exceeded. |
Amtsblattportal (SHAB) | Register history, mentions, publications per canton | Public portal, used through its publication search. |
Zefix web API (optional) | Register status, former names, auditors and audited companies, branches, takeovers, history before the portal's coverage | Not documented for third-party use, which is why it is off by default. The official Zefix REST API needs credentials from the Federal Office of Justice (zefix@bj.admin.ch). |
Every result carries a sources list with the attribution for the sources it used. Pass it on together with the data.
How the server treats the sources
Request budget per call. Default 40. When a question would need more, the call fails with a message asking for a smaller limit, a shorter date window or a canton.
Spacing per source. At least 3.1 seconds between two UID register requests, 0.5 seconds for the others, per process.
Identifying User-Agent with the package name, version and repository.
Caching. Gazette publications do not change once published and are kept in memory for a day; register lookups for ten minutes.
Filter checks. The gazette API ignores some filter combinations without an error (for example
subRubricsnext torubrics, or a misspelled parameter) and then returns unfiltered data. The server checks every list response against the requested canton, type and date window and fails instead of reporting unfiltered data.Subject check. A search for a UID in the gazette also finds publications about other companies that merely name it. History and mentions are told apart by the UID in the publication's company block, not by the search hit.
Limits
The gazette portal returned no publications from before the second half of 2018 in testing. Older register history comes only from the optional Zefix web API.
The name search matches a substring of the registered name. It does not find "Muster Aufzuege" for "Muster Aufzüge", or a name without its hyphen.
A purpose search needs a canton; across all of Switzerland it takes ten seconds or more.
The gazette search serves the first 10,000 hits of a query; the per-canton listing is therefore limited to 31 days per call.
The UID register allows 20 requests per minute per caller. Several agents behind one IP address share that limit.
The current list of officers is not a register field: it is only visible through the publications that changed it.
What it deliberately does not do
No bulk export or crawling of any source.
No telephone directory data. The tel.search.ch terms forbid passing entries or the key on to third parties.
No domain registration data. The SWITCH acceptable use policy excludes advertising and market research.
No debt collection register (Betreibungsregister) data.
Development
npm install
npm run build
npm test # unit tests, no network
npm run smoke # live test against the public sources, about 15 requestsTest fixtures are anonymized copies of real responses: the XML structure is kept, every company name, person, place and UID is replaced.
License
MIT
Available Tools
6 toolsch_company_historyARead-only
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.
Inputs: uid (required), limit, since.
ch_company_mentionsARead-only
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.
Inputs: uid (required), limit.
ch_company_profileARead-only
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.
Inputs: uid (required).
ch_company_searchARead-only
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.
Inputs: query (required), limit, match, canton, +1 more.
ch_register_publicationsARead-only
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.
Inputs: canton (required), page, type, limit, +3 more.
ch_validate_uidARead-only
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.
Inputs: uid (required), lookup.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Related MCP Connectors
Search and verify Swiss companies, UID status and register changes with dated official sources.
Company search and enrichment from official business registers in 200+ countries.
Swiss business verification with per-check source provenance and evidence freshness.
Switzerland company checks by UID: status, liquidation, legal form, LEI and sanctions.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceThe most comprehensive signal intelligence on Swiss businesses — 800K+ companies with people, FINMA/SRO regulatory data, building permits, procurement tenders, and AI-enriched profiles from the official commercial register.-
- AlicenseAqualityDmaintenanceSearch and retrieve detailed information about Swiss companies from the official Zefix register, including company profiles, corporate structures, and SHAB publications.6MIT
- AlicenseAqualityBmaintenanceProvides access to the Swiss Federal Commercial Register (Zefix) for company search, verification, and reference data, enabling natural language queries for public administration use cases.9121 PyPIMIT

swisscoofficial
AlicenseAqualityBmaintenanceAn MCP server for Swiss company data. Nine tools that look a company up by UID, search 790,000 of them by name or by statutory purpose, trace what changed in the commercial register, browse public tenders, check a bank licence, resolve a UID to an LEI and its group parent, and find federally funded research a company took part in. Built by https://prospex.ch9MIT