Server data from the Official MCP Registry
OJP 2.0 journey planning, SIRI-SX disruptions, occupancy, fares, train formation
OJP 2.0 journey planning, SIRI-SX disruptions, occupancy, fares, train formation
Valid MCP server (1 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
3 files analyzed Β· 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-malkreide-swiss-transport-mcp": {
"args": [
"swiss-transport-mcp"
],
"command": "uvx"
}
}
}From the project's GitHub README.
π¨π Part of the Swiss Public Data MCP Portfolio
MCP server connecting AI models to the Swiss public transport system β journey planning, real-time departures, disruptions, occupancy, ticket prices, train formations and open data from opentransportdata.swiss.
swiss-transport-mcp gives AI assistants like Claude a complete Swiss travel information system β not just timetables, but also real-time disruption alerts, occupancy forecasts, ticket prices, and a full train formation view. All accessible through a single, standardised MCP interface.
The various APIs at opentransportdata.swiss speak different protocols β OJP 2.0 (XML/SOAP), SIRI-SX (XML), REST/JSON. This server translates everything into clean JSON for the AI model, acting as a multilingual protocol interpreter.
Anchor demo query: "Plan a school trip for 25 students from Zurich to the Technorama in Winterthur β check for disruptions and find the best departure." β More use cases by audience β
# Clone the repository
git clone https://github.com/malkreide/swiss-transport-mcp.git
cd swiss-transport-mcp
# Install
pip install -e .
Or with uvx (no permanent installation):
uvx swiss-transport-mcp
# Set the minimum required key (OJP core tools)
export TRANSPORT_API_KEY=your_key_here
# Start the server (stdio mode for Claude Desktop)
swiss-transport-mcp
Try it immediately in Claude Desktop:
"What are the next departures from Zurich Stadelhofen?" "How do I get from WΓ€denswil to Bern by train?"
| Variable | API | Required |
|---|---|---|
TRANSPORT_API_KEY | Unified key for OJP + CKAN | β (or individual keys) |
TRANSPORT_OJP_API_KEY | OJP 2.0 Journey Planner | Optional (override) |
TRANSPORT_CKAN_API_KEY | CKAN data catalogue | Optional (separate subscription) |
SIRI_SX_API_KEY | Disruption alerts (SIRI-SX) | Optional |
OCCUPANCY_API_KEY | Occupancy forecast | Optional |
FORMATION_API_KEY | Train formation | Optional |
OJP_FARE_API_KEY | Ticket prices (OJP Fare) | Optional |
APIs without a key are silently disabled β the server starts fine with just the 6 core tools.
Operational / security variables:
| Variable | Effect | Default |
|---|---|---|
MCP_ENV / ENV | Process environment. Must be dev/development/local/test to allow disabling TLS verification. | (unset β production) |
TRANSPORT_SSL_VERIFY | Set to false to disable TLS certificate verification. Honoured only when MCP_ENV marks a dev environment β otherwise the request is ignored and verification stays on. | true |
TRANSPORT_CKAN_URL | Override the CKAN base URL. Must stay on the egress allow-list (*.opentransportdata.swiss); off-site overrides are refused. | https://api.opentransportdata.swiss/ckan-api |
MCP_CORS_ORIGINS | Comma-separated list of browser origins allowed to call the HTTP transport. Use * to allow any origin (not recommended). The Mcp-Session-Id header is exposed to these origins. | https://claude.ai |
LOG_FORMAT | json for structured logs (RFC 5424 severity); anything else for human-readable text. Always written to stderr. | text |
OTEL_TRACES_ENABLED | 1 to enable OpenTelemetry tracing (requires the otel extra: pip install 'swiss-transport-mcp[otel]'). No-op otherwise. | (off) |
MCP_STATELESS | 1 to run the Streamable HTTP transport statelessly β no server-side session state, so instances need no sticky load balancing. Recommended for horizontal scale-out. | (off β stateful) |
π Egress allow-list: all outbound requests are restricted to
https://onopentransportdata.swisshosts. Any other host is refused before a request is sent (SSRF / egress hardening).
Minimal (core tools only):
{
"mcpServers": {
"swiss-transport": {
"command": "swiss-transport-mcp",
"env": {
"TRANSPORT_API_KEY": "your_key_here"
}
}
}
}
Full (all 11 tools):
{
"mcpServers": {
"swiss-transport": {
"command": "swiss-transport-mcp",
"env": {
"TRANSPORT_API_KEY": "your_ojp_key_here",
"SIRI_SX_API_KEY": "your_siri_key_here",
"OCCUPANCY_API_KEY": "your_occupancy_key_here",
"FORMATION_API_KEY": "your_formation_key_here",
"OJP_FARE_API_KEY": "your_fare_key_here"
}
}
}
}
Config file locations:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonFor use via claude.ai in the browser (e.g. on managed workstations without local software). The cloud transport is Streamable HTTP (MCP_TRANSPORT=streamable-http, endpoint /mcp). SSE (/sse) is still supported but deprecated.
MCP_TRANSPORT | Use | Endpoint |
|---|---|---|
stdio (default) | Local Claude Desktop subprocess | β |
streamable-http (or http) | Cloud / container (recommended) | /mcp |
sse | Legacy browser transport (deprecated) | /sse |
Docker (recommended):
# Build + run with explicit resource limits (see docker-compose.yml)
TRANSPORT_API_KEY=xxx docker compose up --build
# β http://127.0.0.1:8000/mcp
The image is a multi-stage build running as a non-root user; docker-compose.yml adds read_only, no-new-privileges and memory/CPU/PID limits.
Render.com:
MCP_TRANSPORT=streamable-http and MCP_HOST=0.0.0.0https://your-app.onrender.com/mcpπ‘ "stdio for the developer laptop, Streamable HTTP for the cloud."
Scaling horizontally: run with MCP_STATELESS=1. In stateless mode the
server keeps no per-session state, so any instance can serve any request and a
plain round-robin load balancer suffices β no sticky sessions / Mcp-Session-Id
affinity required. If you need stateful streaming instead, route by
Mcp-Session-Id at the edge LB (e.g. HAProxy stick-tables) so each session
stays pinned to one instance.
β οΈ Binding: In a network transport the server binds to
127.0.0.1by default so a locally started server is not exposed to your whole network (e.g. public Wi-Fi). SetMCP_HOST=0.0.0.0only in a container/cloud environment where binding to all interfaces is intended (the Docker image does this for you).
| Tool | Description | Data Source |
|---|---|---|
transport_search_stop | Search stops/stations by name | OJP 2.0 |
transport_nearby_stops | Find nearby stops by coordinates | OJP 2.0 |
transport_departures | Real-time departure board with delays & platforms | OJP 2.0 |
transport_trip_plan | Plan journey A β B with transfers, duration, mode | OJP 2.0 |
transport_search_datasets | Search open data catalogue (~90 datasets) | CKANΒΉ |
transport_get_dataset | Get full details of a specific dataset | CKANΒΉ |
ΒΉ CKAN tools require a separate subscription in the API Manager.
| Tool | Description | Data Source |
|---|---|---|
get_transport_disruptions | π¨ Live disruptions, cancellations, line closures | SIRI-SX |
get_train_occupancy | π Occupancy forecast for specific trains | Occupancy JSON |
get_ticket_price | π° Ticket prices for connections | OJP Fare |
get_train_composition | π Train formation, classes, accessibility | Formation REST |
check_transport_api_status | π Health check for all configured APIs | All |
| Query | Tool |
|---|---|
| "Next trains from Zurich Stadelhofen?" | transport_departures |
| "Plan a trip for 25 students from Zurich to Winterthur Technorama" | transport_trip_plan |
| "Any disruptions between Zurich and Bern?" | get_transport_disruptions |
| "How full is IC 1009 today?" | get_train_occupancy |
| "What does a ticket from WΓ€denswil to Bern cost?" | get_ticket_price |
| "Does IC 708 have a dining car?" | get_train_composition |
| "Which stops are near Langstrasse 100?" | transport_nearby_stops |
βββββββββββββββββββ βββββββββββββββββββββββββββββ ββββββββββββββββββββββββββββ
β Claude / AI ββββββΆβ Swiss Transport MCP ββββββΆβ opentransportdata.swiss β
β (MCP Host) βββββββ (MCP Server) βββββββ β
βββββββββββββββββββ β β β OJP 2.0 (XML/SOAP) β
β 11 Tools Β· 2 Resources β β SIRI-SX (XML) β
β Stdio | SSE β β CKAN (REST/JSON) β
β β β Occupancy(REST/JSON) β
β Core: β β Formation(REST/JSON) β
β api_client + ojp_client β β OJP Fare (XML/SOAP) β
β Extensions: β ββββββββββββββββββββββββββββ
β siri_sx, occupancy, β
β ojp_fare, formation β
βββββββββββββββββββββββββββββ
| Component | Metaphor | Function |
|---|---|---|
| RateLimiter | Bouncer | Limits API calls per time window |
| SimpleCache | Whiteboard | Caches responses for repeated queries |
| APIClient | Switchboard | Handles auth, redirects, errors centrally |
| APIConfig | Business card | Key, URL, limits per API |
| API | Cache TTL | Rationale |
|---|---|---|
| SIRI-SX | 120s | Disruptions don't change every second |
| Occupancy | 300s | Forecasts are day-based |
| Formation | 600s | Train composition is stable for the day |
| OJP Fare | 1800s | Prices rarely change intraday |
swiss-transport-mcp/
βββ src/swiss_transport_mcp/ # Main package
β βββ server.py # FastMCP server, tool definitions
β βββ api_client.py # Core OJP + CKAN client
β βββ ojp_client.py # OJP 2.0 XML/SOAP parser
β βββ api_infrastructure.py # RateLimiter, SimpleCache, APIClient
β βββ siri_sx.py # Disruption alerts
β βββ occupancy.py # Occupancy forecasts
β βββ ojp_fare.py # Ticket prices
β βββ formation.py # Train formation
βββ tests/
β βββ test_server.py # Unit + integration tests
βββ .github/workflows/ci.yml # GitHub Actions (Python 3.11/3.12/3.13)
βββ claude_desktop_config.json # Example Claude Desktop config
βββ pyproject.toml
βββ CHANGELOG.md
βββ CONTRIBUTING.md
βββ LICENSE
βββ README.md # This file (English)
βββ README.de.md # German version
RateLimiter (SIRI-SX: 2 req/min, Formation/OJP Fare: 5 req/min) stays within these bounds automatically. Use the limit parameters conservatively for bulk queries.Adding this server to your MCP client lets the connected AI model issue Swiss
public-transport queries on your behalf, using your opentransportdata.swiss
API key, and make outbound HTTPS requests to opentransportdata.swiss. Nothing
is written upstream and no PII is stored, but you should review the tool list
above and confirm you are comfortable granting that access before configuring
the server.
The server has no authentication of its own. When you run the Streamable
HTTP transport (MCP_TRANSPORT=streamable-http), the MCP SDK issues a
cryptographically random Mcp-Session-Id per session, but there is no user
identity bound to it. Therefore:
MCP_HOST=127.0.0.1 for local use; only bind 0.0.0.0
inside a controlled container/cloud environment (see Deployment).MCP_CORS_ORIGINS to the origins you actually trust.See SECURITY.md for the full security posture and the
accepted-risk decisions (gateway-level controls).
filter_text parameter# Unit tests (no API key required)
PYTHONPATH=src pytest tests/ -m "not live"
# Integration tests (API key required)
TRANSPORT_API_KEY=xxx pytest tests/ -m "live"
See CHANGELOG.md
See CONTRIBUTING.md
MIT License β see LICENSE
Hayal Oezkan Β· github.com/malkreide
Be the first to review this server!
by Modelcontextprotocol Β· Developer Tools
Read, search, and manipulate Git repositories programmatically
by Modelcontextprotocol Β· Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno Β· Developer Tools
Toleno Network MCP Server β Manage your Toleno mining account with Claude AI using natural language.