swissco-mcp
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
09278738910558e1787b705946256e761e7cf6dc22929dfcce0efeb6ee9f9537
|
|
| MD5 |
9dc1ec338ed1f1bdd3e050481689575e
|
|
| BLAKE2b-256 |
0b10422dc2e18b752fc4efda4d307483306c2610797a12aa18bd60f6b4e1b3ad
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
091d76e4698ac5cfc59cde2e867a4bf20f566151e7689f827608b19bb5ce6a57
|
|
| MD5 |
bf0c9a1af36cdbe846b36569a9fa5de0
|
|
| BLAKE2b-256 |
52b92214d8716f0535575d272c95d8dee9b515962b9f19d924982254ce4beaa2
|