Skip to main content
Glama

swissco-mcp

PyPI Documentation

An MCP server for Swiss company data, built and maintained by Prospex, a Swiss B2B sales intelligence platform. 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.

claude mcp add swissco -- uvx swissco-mcp

All data comes from six open-data sources, none of which needs a credential: Zefix on LINDAS for the commercial register, the Amtsblattportal for the Swiss Official Gazette of Commerce, simap.ch for public procurement, FINMA for authorised banks and securities firms, GLEIF for the Legal Entity Identifier and group structure, and ARAMIS for federally funded research.

Install

The server runs over stdio and needs Python 3.14 or newer.

uvx swissco-mcp              # run it without installing
pip install swissco-mcp      # or install it

Registering it depends on the host. Claude Code takes one command:

claude mcp add swissco -- uvx swissco-mcp

Anything that reads a JSON config takes the equivalent block:

{
  "mcpServers": {
    "swissco": {
      "command": "uvx",
      "args": ["swissco-mcp"]
    }
  }
}

Related MCP server: mcp-swiss

Tools

Tool

What it answers

swissco_lookup

Everything the register publishes about one company, optionally with its FINMA licence and its LEI

swissco_search

Companies whose legal name or statutory purpose contains a term

swissco_publications

Commercial-register publications from the gazette in a date range

swissco_events

One company's registry events, each confirmed against the publication's own UID

swissco_tenders

Public-procurement projects published on simap

swissco_vendor

Whether a company holds a simap vendor profile, and what it says

swissco_finma

Institutions on FINMA's list of authorised banks and securities firms

swissco_lei

A company's LEI, the entity that consolidates it, and the entity at the top of that chain

swissco_research

Federally funded research projects, Innosuisse and SNSF money included

Every tool returns the same envelope: rows, a count, and notes.

What the notes carry

Each source covers a slice of Swiss economic life, and a company's absence from one of them usually means it sits outside that slice. notes says which:

  • FINMA's list covers banks and securities firms. Insurers, portfolio managers and fund management companies hold their authorisations on other lists, so a company missing here may still be supervised.

  • About 28,000 Swiss entities hold an LEI, against roughly 790,000 in the commercial register. An absent LEI is the normal case.

  • ARAMIS searches project titles, abstracts and a free-text contractor field, and indexes the structured participant list under none of them. A company named only as a structured partner cannot be found through it.

  • LINDAS publishes the active commercial register. A deleted company can be missing from it while its gazette publications remain.

notes also reports what a call did with a request it had to trim, and how many requests a wide date range is about to cost.

Configuration

Every tool works with no configuration at all. Four environment variables change what it does:

Variable

Effect

ZEFIX_USER, ZEFIX_PASSWORD

Zefix PublicREST credentials, issued by zefix@bj.admin.ch. They add capital, status, former names and corporate relations to swissco_lookup, and a name-prefix search to swissco_search

SWISSCO_STATE

Where gazette bodies and the two FINMA files are cached. Defaults to ~/.swissco

SWISSCO_INTERVAL

Seconds between requests. It can raise the floor of 0.5s and cannot lower it

Rate limiting

Requests are paced at half a second apart, and each source that asks for something slower gets it: FINMA is paced at a second. These are small public services run by federal offices, and SWISSCO_INTERVAL can raise that floor but never lower it.

The command line

The same data is available as a shell command, from the same repository:

uvx swissco lookup CHE-444.420.929

See swissco on PyPI and its documentation.

Documentation

Full reference for every tool, its arguments and its caveats: swissco-mcp.readthedocs.io.

Licence

MIT. The data belongs to its publishers, and each source's own terms apply; the access and terms section lists them.

Available Tools

9 tools
swissco_eventsA
Read-onlyIdempotent

One company's registry events, each confirmed against the publication's own UID.

Each row carries publication_date, event_type, effective_date, company_name, uid, canton, sub_rubric, id and url, newest first.

The gazette's list page carries a title and no UID, so the UID resolves to a legal name, the name selects candidate publications, and each candidate's body is fetched and kept only when its own UID matches. A publication carrying no UID is dropped.

Bodies are cached under the state directory and keyed by publication id, so an overlapping second call over the same range costs almost nothing.

Inputs: uid (required), limit, since, until. Returns: rows, count, notes

swissco_finmaA
Read-onlyIdempotent

Institutions on FINMA's list of authorised banks and securities firms.

Each row carries name, city, licence_type, supervisory_category, uid, foreign_control, no_securities_firm_activity, non_account_holding_securities_firm and about_to_cease_operations.

This one list covers banks and securities firms. Insurers, portfolio managers and fund management companies hold their authorisations on other FINMA lists, so a company absent here may still be supervised. FINMA also publishes some authorised institutions with no UID, which no UID lookup can reach.

Both published files are cached under the state directory for a day, so the first call in a day is the slow one.

Inputs: uid, limit, query, category, +1 more. Returns: rows, count, notes

swissco_leiA
Read-onlyIdempotent

A company's Legal Entity Identifier and the group it is consolidated into.

One row: legal_name, lei, registered_as, jurisdiction, status, registration_status, legal_form, city, country, other_names, bic, initial_registration_date, last_update_date, next_renewal_date, direct_parent, ultimate_parent and direct_children.

With children, one row per consolidated entity: legal_name, lei, jurisdiction, registered_as, status, city and country.

GLEIF Level 2 records accounting consolidation, so a parent here is the entity that consolidates this one into its accounts. That parent is frequently foreign, which is the case for reading it: the Swiss commercial register carries no entry for a Swiss company's owner abroad.

About 28,000 Swiss entities hold an LEI against roughly 790,000 in the commercial register. An absent LEI is the normal case.

Inputs: uid (required), limit, children. Returns: rows, count, notes

swissco_lookupA
Read-onlyIdempotent

Everything the commercial register publishes about one company.

One row: legal_name, uid, chid, ehra_id, legal_form_code, legal_form, municipality, canton, address, purpose and zefix_uri. With Zefix PublicREST credentials in the environment it also carries status, capital_nominal, capital_currency, deletion_date, old_names, branch_offices, head_offices, has_taken_over, was_taken_over_by and cantonal_excerpt.

finma_licence adds finma_licence, finma_category, finma_city and finma_flags. lei adds lei, lei_status, direct_parent and ultimate_parent.

purpose is the statutory purpose: how the company describes what it does, in its own words, filed with the register.

Inputs: uid (required), lei, finma_licence. Returns: rows, count, notes

swissco_publicationsA
Read-onlyIdempotent

Commercial-register publications from the Swiss Official Gazette of Commerce.

Each row carries publication_date, canton, sub_rubric, title, language, state, id and url. With event_types, each body is fetched and parsed, and the rows instead carry publication_date, canton, sub_rubric, company_name, uid, events, effective_date, state, id and url.

The event types are: INCORPORATION, BRANCH_CREATED, SEAT_MOVED, ADDRESS_CHANGED, NAME_CHANGED, PURPOSE_CHANGED, CAPITAL_INCREASED, MERGER, OFFICERS_CHANGED, LIQUIDATION, DELETED.

The gazette publishes around a thousand commercial-register entries a day. Every filter here is applied over the listed publications, because the anonymous API ignores its own cantons, subRubrics and q parameters.

Inputs: limit, query, since, until, +3 more. Returns: rows, count, notes

swissco_researchA
Read-onlyIdempotent

Federally funded research projects from ARAMIS, Innosuisse and SNSF money included.

A text query returns rows of title, project_number, office, status, start_date, end_date, granted_total_costs, participants and aramis_id.

A UID searches ARAMIS for the company's name, then keeps only projects carrying a participant whose own UID matches, and reports role and uid in place of participants.

ARAMIS searches project titles, abstracts and the free-text contractor field, and indexes the structured participant list under none of them. A company named only as a structured partner cannot be found, which is where Innosuisse implementation partners usually sit. An empty result means no project mentions the company by name, and is not evidence that it took no federal research money.

Inputs: query (required), limit, language. Returns: rows, count, notes

swissco_tendersA
Read-onlyIdempotent

Public-procurement projects published on simap.

Each row carries title, project_number, buyer, canton, city, project_type, process_type, publication_date, publication_type, project_id and publication_id.

The publication types are: abandonment, advance_notice, award, competition, direct_award, participant_selection, request_for_information, revocation, selective_offering_phase, study_contract, tender.

The date matches each project's newest publication, whichever type that publication is, and pub_types is what narrows it to awards. The supplier named on an award carries no UID, so this lists projects and buyers. Use swissco_vendor for whether a given company is in simap's vendor directory.

Inputs: lang, limit, since, until, +2 more. Returns: rows, count, notes

swissco_vendorA
Read-onlyIdempotent

A company in simap's vendor directory, by UID or by name.

A text query returns rows of name, uid_no, canton, city, postal_code, active, is_bidding_consortium and vendor_id.

A UID resolves to a legal name, searches the directory for it and keeps only profiles whose own uidNo matches, then returns that profile: name, uid_no, additional_name, street, postal_code, city, canton, url, company_size, type_of_services, cpv_codes, bkp_codes, npk_codes, business_purpose, is_bidding_consortium, leading_vendor_name and vendor_id.

A company can bid without holding a directory profile, and a bidding consortium carries no UID at all, so an absent UID means only that no profile is filed under it.

Inputs: query (required), limit. Returns: rows, count, notes

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 9 tools

    Disambiguation4/5

    Each tool maps to a distinct data source or action (register lookup, register search, gazette feed, company events, tenders, vendor directory, FINMA, LEI, research). The only real overlap is between swissco_publications (general gazette stream) and swissco_events (gazette events for one company), but the descriptions clearly distinguish the two scopes.

    Naming Consistency4/5

    All tools share the swissco_ prefix and snake_case formatting, giving a predictable namespace. The suffix mixes action words (lookup, search) with data-source nouns (finma, lei, tenders, research), a minor inconsistency but still readable and non-ambiguous.

    Tool Count5/5

    Nine tools is well-scoped for a multi-source Swiss company-data aggregator. Each tool covers a genuinely distinct source, so none feels redundant or padded.

    Completeness4/5

    The surface covers identities (lookup/search), registry activity (publications/events), public money (tenders/research), and supervision (finma/lei/vendor) — a strong lifecycle view. Minor gaps exist (e.g. no way to filter by canton or list all results), but agents can work around these with the provided filters.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Nordic company registries. Verify companies, check board members, signing authority, and financial data across Norway, Denmark, Finland, and Sweden using official public APIs. 23 tools covering search, details, roles, and batch lookups.
      19
      14
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for EU company and business data. 9 tools: company search (GLEIF, 2M+ entities), LEI lookup, corporate structures (parent/subsidiaries), trade register search, EU VAT validation (VIES), GDP, unemployment, inflation, and business demography (Eurostat). All APIs free, no keys required.
      9
      6
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server for interacting with the Swiss Commercial Register via Zefix REST API and UID Webservice, enabling company search, validation, SOGC publications, and due diligence reports.
      9
      5
      MIT