Back to Browse

Swissreg MCP Server

Developer ToolsModerate5.9MCP RegistryLocal
Free

Server data from the Official MCP Registry

Swiss company data: register lookups, gazette publications, tenders, FINMA, LEI and research.

About

Swiss company data: register lookups, gazette publications, tenders, FINMA, LEI and research.

Security Report

5.9
Moderate5.9Moderate Risk

swissreg is a read-only client for Swiss open-data sources (LINDAS, Gazette, simap, FINMA, GLEIF, ARAMIS) with no credentials required for core paths; optional Zefix credentials are read from environment variables and sent only to the Zefix endpoint over HTTPS. No exfiltration, shell execution, or hardcoded secrets were observed in the reviewed code, though the review is incomplete because swiss.ts was truncated and the ARAMIS/research section and remaining files were not visible. Minor concerns are limited to string-interpolated SPARQL and URL construction with partial escaping, and the lack of visibility into the remaining code. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

5 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

ZEFIX_USERRequired
ZEFIX_PASSWORDRequired

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "swissreg": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/swissreg@0.1.0"
      ],
      "env": {
        "ZEFIX_USER": "your-zefix-user-here",
        "ZEFIX_PASSWORD": "your-zefix-password-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

swissreg

Nine read-only questions about Swiss companies, answered from the public registers Switzerland itself publishes — no account needed for the core paths, because the sources are open data: the commercial register via LINDAS, the Swiss Official Gazette of Commerce, the simap procurement platform, FINMA's list of authorised institutions, the GLEIF legal-entity database, and the federal ARAMIS research database.

Every answer comes back in the same envelope: a JSON object with rows (each row carrying exactly the fields documented for that tool, in order), count, and notes explaining the limits of what the source can say — for example that an absent LEI is the normal case (only about 28,000 Swiss entities hold one), or that a company can bid on simap without holding a directory profile.

The nine tools:

  • swissco_lookup — everything the commercial register publishes about one company, by UID; optionally adds its FINMA licence fields and its LEI with consolidating parents.
  • swissco_search — companies whose legal name or statutory purpose contains a term, with canton and legal-form filters on the LINDAS path.
  • swissco_publications — Gazette publications in a date range, filtered client-side by canton, sub-rubric, title text, or event type.
  • swissco_events — one company's registry events, each kept only when the publication's own UID matches the one asked for.
  • swissco_tenders — public-procurement projects published on simap, by date range, canton, and publication type.
  • swissco_vendor — whether a company holds a simap vendor profile, and what that profile says.
  • swissco_finma — institutions on FINMA's authorised banks and securities-firms list, filterable by name, UID, licence type, and supervisory category.
  • swissco_lei — a company's LEI, the entity that consolidates it, the top of that chain, and optionally its consolidated children.
  • swissco_research — federally funded research projects (Innosuisse and SNSF money included) naming a company, by text or by a participant's UID.

Swiss UIDs are taken seriously: a UID is normalised (CHE444420929, CHE-444.420.929 and lower-case variants all work), its modulo-11 check digit is verified before any request is made, and output UIDs are always punctuated CHE-XXX.XXX.XXX. Dates are YYYY-MM-DD; date ranges that the Gazette cannot serve are trimmed to their newest days, with a note saying so.

Configuration

No credential is required. Two things are optional:

export ZEFIX_USER="..."        # Zefix PublicREST account
export ZEFIX_PASSWORD="..."

With those set, swissco_search can run with via: "rest" (a name-prefix search with richer fields); without them that path fails honestly, naming the two variables. Register lookups otherwise run over LINDAS and note what credentials would add: capital, status, former names, and corporate relations.

CLI

Each tool is a subcommand taking one JSON argument string:

npx @reneturcios/swissreg swissco_lookup '{"uid":"CHE-444.420.929","lei":true}'
npx @reneturcios/swissreg swissco_search '{"term":"pharma","canton":"BS"}'
npx @reneturcios/swissreg swissco_tenders '{"pub_types":["award"],"cantons":["ZH"]}'
npx @reneturcios/swissreg --version

Output is the tool's envelope as JSON. Exit codes: 0 on success, 1 on a runtime error (including a validation or upstream failure), 2 on a usage error.

MCP server

npx -y @reneturcios/swissreg mcp

MCP client config:

{
  "mcpServers": {
    "swissreg": {
      "command": "npx",
      "args": ["-y", "@reneturcios/swissreg", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/swissreg
docker run --rm ghcr.io/cloudcorprecords/swissreg swissco_finma '{"licence_type":"Bank"}'

Development

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch + fake clock, no network)
npm run dev     # run the CLI from source

License

MIT — Copyright (c) 2026 Rene Turcios

Reviews

No reviews yet

Be the first to review this server!