# Swissyphus

> Swissyphus is an open-source MCP server for analytics and data. Query 66 Swiss public data sources through 151 cited tools, with no API keys. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/cwellbournewood/swissyphus
- **MCP Registry name:** io.github.cwellbournewood/swissyphus
- **Categories:** analytics and data, legal and government
- **Listing updated:** 2026-11-15

## About

Swissyphus covers Swiss public data in areas such as timetables and mobility, weather, avalanche and snow, property and cadastre, company registers, sanctions, federal law, parliament and voting results, statistics and health. Every tool returns one envelope: the data, the publisher and its licence, a data-as-of date that stays null when the publisher gives none, a cache status, and the exact upstream requests behind the answer with credentials redacted.

A discovery tool searches opendata.swiss, about 900 federal map layers, statistical tables, LINDAS cubes and other catalogues at once and returns the call that fetches the data. Due-diligence tools screen against the SECO sanctions list, look up the UID and commercial registers and SOGC, and search court decisions, public tenders and federal law. Caching, circuit breakers and a nightly canary keep it running, and when a source is down it returns the last good answer, marked as stale. A discovery preset keeps only 7 tools in context while still reaching all 151.

It is an independent MIT-licensed project, not endorsed by the Swiss Confederation, and each source keeps its own licence. Some need attribution and some limit commercial use. Run it with npx, Docker or as a self-hosted REST API with OpenAPI 3.1 and a remote MCP endpoint. An optional free opentransportdata.swiss key adds real-time public-transport delays.

## Features

- **Cited answers:** Each response names the source, licence, retrieval time and upstream requests.
- **Catalogue search:** find_data searches many Swiss open-data catalogues and returns the call to fetch the data.
- **Due diligence tools:** Sanctions screening, UID and commercial register lookups, courts, tenders and federal law.
- **Stale-safe caching:** Serves the last good answer, marked stale, when a source is down.
- **Presets:** A discovery preset exposes 7 tools while still reaching all 151.
- **Self-hostable:** Docker image with a REST API, OpenAPI spec and remote MCP endpoint.

## Good for

- Look up the next train between two Swiss cities and mountain snow conditions
- Screen a name against the Swiss sanctions list
- Check a company in the commercial register and recent SOGC notices
- Find zoning and building restrictions for an address
- Check whether a federal law is still in force

## Install

### Claude Code (Terminal)

```sh
claude mcp add swissyphus --env OPENTRANSPORTDATA_API_KEY='<OPENTRANSPORTDATA_API_KEY>' -- npx -y swissyphus
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "swissyphus": {
      "command": "npx",
      "args": [
        "-y",
        "swissyphus"
      ],
      "env": {
        "OPENTRANSPORTDATA_API_KEY": "<OPENTRANSPORTDATA_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "swissyphus": {
      "command": "npx",
      "args": [
        "-y",
        "swissyphus"
      ],
      "env": {
        "OPENTRANSPORTDATA_API_KEY": "<OPENTRANSPORTDATA_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "swissyphus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "swissyphus"
      ],
      "env": {
        "OPENTRANSPORTDATA_API_KEY": "<OPENTRANSPORTDATA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "swissyphus": {
      "command": "npx",
      "args": [
        "-y",
        "swissyphus"
      ],
      "env": {
        "OPENTRANSPORTDATA_API_KEY": "<OPENTRANSPORTDATA_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "swissyphus": {
      "command": "npx",
      "args": [
        "-y",
        "swissyphus"
      ],
      "env": {
        "OPENTRANSPORTDATA_API_KEY": "<OPENTRANSPORTDATA_API_KEY>"
      }
    }
  }
}
```

## Tools

- `find_data`: Search many Swiss catalogues and return the call that fetches the data.
- `find_tools`: Search the available tools.
- `describe_tool`: Describe a tool.
- `call_tool`: Call any tool by name.
- `list_sources`: The licence register for all 66 sources.
- `check_source_health`: Check whether a source is working.

## FAQ

### Do I need API keys?

No signups or keys are needed; an optional free opentransportdata.swiss key adds real-time public-transport delays.

### How do I install it?

Run claude mcp add --scope user swissyphus -- npx -y swissyphus, add the npx command to any client, or use Docker. Node.js 20 or newer is required.

### What licence does the data have?

The server is MIT-licensed, but data keeps its own licences, stated in each response; some sources limit commercial use.

### Is it an official Swiss service?

No. It is an independent open-source project not operated or endorsed by the Swiss Confederation, any canton or any data provider.

### Can I self-host it?

Yes. A Docker image serves the same tools over REST with an OpenAPI 3.1 spec and a remote MCP endpoint.

### Is Swissyphus free?

Yes. Swissyphus is open source, so you can use and self-host it for free.

### How do I add Swissyphus to Claude Code?

Run this command in your terminal: claude mcp add swissyphus --env OPENTRANSPORTDATA_API_KEY='<OPENTRANSPORTDATA_API_KEY>' -- npx -y swissyphus

### What are the best alternatives to Swissyphus?

The closest alternatives to Swissyphus are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/swissyphus
