Skip to main content

swissco-mcp

PyPI Documentation

An 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.

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.

Built and maintained by Prospex, a Swiss B2B sales intelligence platform.

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"]
    }
  }
}

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swissco_mcp-0.1.0.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

swissco_mcp-0.1.0-py3-none-any.whl (15.3 kB view details)

Uploaded Python 3

File details

Details for the file swissco_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: swissco_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for swissco_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 09278738910558e1787b705946256e761e7cf6dc22929dfcce0efeb6ee9f9537
MD5 9dc1ec338ed1f1bdd3e050481689575e
BLAKE2b-256 0b10422dc2e18b752fc4efda4d307483306c2610797a12aa18bd60f6b4e1b3ad

See more details on using hashes here.

File details

Details for the file swissco_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: swissco_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for swissco_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 091d76e4698ac5cfc59cde2e867a4bf20f566151e7689f827608b19bb5ce6a57
MD5 bf0c9a1af36cdbe846b36569a9fa5de0
BLAKE2b-256 52b92214d8716f0535575d272c95d8dee9b515962b9f19d924982254ce4beaa2

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.1

2 files

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page