sbb-mcp 0.1.3 → 0.2.0

package/LICENSE

@@ -1,57 +1,57 @@
-# Functional Source License, Version 1.1, MIT Future License
-
-## Abbreviation
-FSL-1.1-MIT
-
-## Notice
-Copyright 2026 SwissTrip (F. Weinhappl)
-
-## Terms and Conditions
-
-### Licensor ("We")
-The party offering the Software under these Terms and Conditions.
-
-### The Software
-The "Software" is each version of the software that we make available under these Terms and Conditions, as indicated by our inclusion of these Terms and Conditions with the Software.
-
-### License Grant
-Subject to your compliance with this License Grant and the Patents, Redistribution and Trademark clauses below, we hereby grant you the right to use, copy, modify, create derivative works, publicly perform, publicly display and redistribute the Software for any Permitted Purpose identified below.
-
-### Permitted Purpose
-A Permitted Purpose is any purpose other than a Competing Use. A Competing Use means making the Software available to others in a commercial product or service that:
-
-1. substitutes for the Software;
-2. substitutes for any other product or service we offer using the Software that exists as of the date we make the Software available; or
-3. offers the same or substantially similar functionality as the Software.
-
-Permitted Purposes specifically include using the Software:
-
-1. for your internal use and access;
-2. for non-commercial education;
-3. for non-commercial research; and
-4. in connection with professional services that you provide to a licensee using the Software in accordance with these Terms and Conditions.
-
-### Patents
-To the extent your use for a Permitted Purpose would necessarily infringe our patents, the license grant above includes a license under our patents. If you make a claim against any party that the Software infringes or contributes to the infringement of any patent, then your patent license to the Software ends immediately.
-
-### Redistribution
-The Terms and Conditions apply to all copies, modifications and derivatives of the Software.
-
-If you redistribute any copies, modifications or derivatives of the Software, you must include a copy of or a link to these Terms and Conditions and not remove any copyright notices provided in or with the Software.
-
-### Disclaimer
-THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
-
-IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
-
-### Trademarks
-Except for displaying the License Details and identifying us as the origin of the Software, you have no right under these Terms and Conditions to use our trademarks, trade names, service marks or product names.
-
-## Grant of Future License
-We hereby irrevocably grant you an additional license to use the Software under the MIT license that is effective on the second anniversary of the date we make the Software available. On or after that date, you may use the Software under the MIT license, in which case the following will apply:
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+FSL-1.1-MIT
+
+## Notice
+Copyright 2026 SwissTrip (F. Weinhappl)
+
+## Terms and Conditions
+
+### Licensor ("We")
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+The "Software" is each version of the software that we make available under these Terms and Conditions, as indicated by our inclusion of these Terms and Conditions with the Software.
+
+### License Grant
+Subject to your compliance with this License Grant and the Patents, Redistribution and Trademark clauses below, we hereby grant you the right to use, copy, modify, create derivative works, publicly perform, publicly display and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use means making the Software available to others in a commercial product or service that:
+
+1. substitutes for the Software;
+2. substitutes for any other product or service we offer using the Software that exists as of the date we make the Software available; or
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+2. for non-commercial education;
+3. for non-commercial research; and
+4. in connection with professional services that you provide to a licensee using the Software in accordance with these Terms and Conditions.
+
+### Patents
+To the extent your use for a Permitted Purpose would necessarily infringe our patents, the license grant above includes a license under our patents. If you make a claim against any party that the Software infringes or contributes to the infringement of any patent, then your patent license to the Software ends immediately.
+
+### Redistribution
+The Terms and Conditions apply to all copies, modifications and derivatives of the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software, you must include a copy of or a link to these Terms and Conditions and not remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+Except for displaying the License Details and identifying us as the origin of the Software, you have no right under these Terms and Conditions to use our trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+We hereby irrevocably grant you an additional license to use the Software under the MIT license that is effective on the second anniversary of the date we make the Software available. On or after that date, you may use the Software under the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,232 +1,276 @@
-# sbb-mcp
-
-[![npm version](https://img.shields.io/npm/v/sbb-mcp.svg)](https://www.npmjs.com/package/sbb-mcp)
-[![License: FSL-1.1-MIT](https://img.shields.io/badge/License-FSL--1.1--MIT-blue.svg)](https://fsl.software/)
-[![smithery badge](https://smithery.ai/badge/fabsforward2-zhoi/sbb-mcp)](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp)
-
-MCP server for **Swiss Federal Railways** (SBB/CFF/FFS) -- real-time train schedules, prices, and ticket purchase links for any AI assistant.
-
-Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, ChatGPT, and any MCP-compatible AI client.
-
-## Features
-
-- **Search stations** -- find any Swiss train station by name
-- **Train connections** -- real-time schedules with departure/arrival times, platforms, transfers
-- **Ticket prices** -- 1st/2nd class with Half-Fare (Halbtax) and GA travelcard support
-- **Purchase links** -- direct deep links to buy tickets on SBB.ch
-- **Pagination** -- browse earlier/later connections
-- **Trip details** -- intermediate stops, occupancy, platform changes
-- **Journey planning** -- built-in prompt for end-to-end trip planning
-- **Mock mode** -- works without credentials for testing and demos
-
-## Quick Start
-
-### Claude Desktop
-
-Add to your `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "sbb": {
-      "command": "npx",
-      "args": ["-y", "sbb-mcp"],
-      "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SMAPI_CONTRACT_ID": "your-contract-id"
-      }
-    }
-  }
-}
-```
-
-### Claude Code
-
-```bash
-claude mcp add sbb -- npx -y sbb-mcp
-```
-
-### Cursor
-
-Add to `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "sbb": {
-      "command": "npx",
-      "args": ["-y", "sbb-mcp"],
-      "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SMAPI_CONTRACT_ID": "your-contract-id"
-      }
-    }
-  }
-}
-```
-
-### Windsurf
-
-Add to `~/.codeium/windsurf/mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "sbb": {
-      "command": "npx",
-      "args": ["-y", "sbb-mcp"],
-      "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SMAPI_CONTRACT_ID": "your-contract-id"
-      }
-    }
-  }
-}
-```
-
-### VS Code Copilot
-
-Add to `.vscode/mcp.json`:
-
-```json
-{
-  "servers": {
-    "sbb": {
-      "command": "npx",
-      "args": ["-y", "sbb-mcp"],
-      "env": {
-        "SMAPI_CLIENT_ID": "your-client-id",
-        "SMAPI_CLIENT_SECRET": "your-secret",
-        "SMAPI_SCOPE": "your-scope",
-        "SMAPI_CONTRACT_ID": "your-contract-id"
-      }
-    }
-  }
-}
-```
-
-### Smithery
-
-Install via [Smithery](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp):
-
-```bash
-npx @smithery/cli mcp add fabsforward2-zhoi/sbb-mcp
-```
-
-### Demo Mode (No Credentials)
-
-Run without any environment variables to use mock data:
-
-```bash
-npx sbb-mcp
-```
-
-This lets you test the MCP server with realistic Swiss station data without SBB API credentials.
-
-## Tools
-
-### search_stations
-
-Search for Swiss train stations by name. Returns station IDs needed for other tools.
-
-**Input:**
-- `query` (string, required) -- Station name, e.g. "Zurich", "Bern", "Interlaken"
-- `limit` (number, optional) -- Max results (default: 10)
-
-**Example:** "Find stations matching Luzern"
-
-### search_connections
-
-Find train connections between two stations. Automatically resolves station names to IDs.
-
-**Input:**
-- `from` (string, required) -- Origin station name or ID (e.g. "Zurich HB" or "8503000")
-- `to` (string, required) -- Destination station name or ID
-- `date` (string, optional) -- Travel date YYYY-MM-DD
-- `time` (string, optional) -- Departure time HH:MM
-- `arrival_time` (boolean, optional) -- Treat time as arrival time
-
-**Example:** "Show me trains from Zurich to Bern tomorrow at 9am"
-
-### get_trip_details
-
-Get detailed stop-by-stop information for a connection including intermediate stops, platforms, and occupancy forecasts.
-
-**Input:**
-- `trip_id` (string, required) -- Trip ID from search_connections
-
-### get_more_connections
-
-Load earlier or later trains for a previous search.
-
-**Input:**
-- `collection_id` (string, required) -- Collection ID from search_connections
-- `direction` ("next" | "previous") -- Later or earlier trains
-
-### get_prices
-
-Get ticket prices with Swiss reduction card support.
-
-**Input:**
-- `trip_ids` (string[], required) -- Trip IDs from search_connections
-- `traveler_type` ("ADULT" | "CHILD", default: "ADULT")
-- `reduction_card` ("HALF_FARE" | "GA" | "NONE", default: "HALF_FARE")
-
-**Example:** "How much is a ticket from Zurich to Zermatt with Half-Fare card?"
-
-### get_ticket_link
-
-Get a direct purchase link to buy the ticket on SBB.ch. Only call when the user wants to buy.
-
-**Input:**
-- `trip_id` (string, required) -- Trip ID to purchase
-- `traveler_type` ("ADULT" | "CHILD", default: "ADULT")
-- `reduction_card` ("HALF_FARE" | "GA" | "NONE", default: "HALF_FARE")
-
-## Prompts
-
-### plan_journey
-
-End-to-end journey planning prompt. Searches connections, compares prices, and provides ticket links.
-
-**Input:**
-- `from` (string, required) -- Origin station
-- `to` (string, required) -- Destination station
-- `date` (string, optional) -- Travel date
-
-## Environment Variables
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `SMAPI_CLIENT_ID` | Yes* | OAuth 2.0 client ID from SBB Developer Portal |
-| `SMAPI_CLIENT_SECRET` | Yes* | OAuth 2.0 client secret |
-| `SMAPI_SCOPE` | Yes* | OAuth scope |
-| `SMAPI_CONTRACT_ID` | Yes* | SBB business contract ID |
-| `SMAPI_ENV` | No | `int` (default) or `prod` |
-| `SMAPI_TENANT_ID` | No | Azure AD tenant (defaults to SBB tenant) |
-
-*Without credentials, the server runs in mock mode with realistic demo data.
-
-## Available on
-
-- [npm](https://www.npmjs.com/package/sbb-mcp)
-- [Official MCP Registry](https://registry.modelcontextprotocol.io)
-- [Smithery](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp)
-
-Also available as: [sbb-mcp-official](https://www.npmjs.com/package/sbb-mcp-official) | [swiss-rail-mcp](https://www.npmjs.com/package/swiss-rail-mcp) | [sbb-cff-ffs-mcp](https://www.npmjs.com/package/sbb-cff-ffs-mcp) | [swiss-train-mcp](https://www.npmjs.com/package/swiss-train-mcp) | [swiss-railways-mcp](https://www.npmjs.com/package/swiss-railways-mcp)
-
-## About
-
-Built on the official SBB Swiss Mobility API (SMAPI) with OSDM-compliant journey planning and pricing. Covers the entire Swiss public transport network including SBB, BLS, SOB, and regional operators.
-
-**SBB** (Schweizerische Bundesbahnen) / **CFF** (Chemins de fer federaux suisses) / **FFS** (Ferrovie federali svizzere) -- Swiss Federal Railways operates one of the densest rail networks in the world with over 10,000 daily connections.
-
-## License
-
-[FSL-1.1-MIT](https://fsl.software/) -- Functional Source License. Free to use for any non-competing purpose. Converts to MIT after 2 years. See [LICENSE](LICENSE) for details.
+# sbb-mcp
+
+[![npm version](https://img.shields.io/npm/v/sbb-mcp.svg)](https://www.npmjs.com/package/sbb-mcp)
+[![License: FSL-1.1-MIT](https://img.shields.io/badge/License-FSL--1.1--MIT-blue.svg)](https://fsl.software/)
+[![smithery badge](https://smithery.ai/badge/fabsforward2-zhoi/sbb-mcp)](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp)
+
+MCP server for **Swiss Federal Railways** (SBB/CFF/FFS) -- real-time train schedules, prices, and ticket purchase links for any AI assistant.
+
+Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, ChatGPT, and any MCP-compatible AI client.
+
+## Features
+
+- **Search stations** -- find any Swiss train station by name
+- **Train connections** -- real-time schedules with departure/arrival times, platforms, transfers
+- **Ticket prices** -- 1st/2nd class with Half-Fare (Halbtax) and GA travelcard support
+- **Purchase links** -- direct deep links to buy tickets on SBB.ch
+- **Pagination** -- browse earlier/later connections
+- **Trip details** -- intermediate stops, occupancy, platform changes
+- **Journey planning** -- built-in prompt for end-to-end trip planning
+- **Multi-traveler** -- family trip pricing when connected to SwissTrip (partner, kids, each with their own reduction card)
+- **Mock mode** -- works without credentials for testing and demos
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "sbb": {
+      "command": "npx",
+      "args": ["-y", "sbb-mcp"],
+      "env": {
+        "SMAPI_CLIENT_ID": "your-client-id",
+        "SMAPI_CLIENT_SECRET": "your-secret",
+        "SMAPI_SCOPE": "your-scope",
+        "SMAPI_CONTRACT_ID": "your-contract-id"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add sbb -- npx -y sbb-mcp
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "sbb": {
+      "command": "npx",
+      "args": ["-y", "sbb-mcp"],
+      "env": {
+        "SMAPI_CLIENT_ID": "your-client-id",
+        "SMAPI_CLIENT_SECRET": "your-secret",
+        "SMAPI_SCOPE": "your-scope",
+        "SMAPI_CONTRACT_ID": "your-contract-id"
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "sbb": {
+      "command": "npx",
+      "args": ["-y", "sbb-mcp"],
+      "env": {
+        "SMAPI_CLIENT_ID": "your-client-id",
+        "SMAPI_CLIENT_SECRET": "your-secret",
+        "SMAPI_SCOPE": "your-scope",
+        "SMAPI_CONTRACT_ID": "your-contract-id"
+      }
+    }
+  }
+}
+```
+
+### VS Code Copilot
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "sbb": {
+      "command": "npx",
+      "args": ["-y", "sbb-mcp"],
+      "env": {
+        "SMAPI_CLIENT_ID": "your-client-id",
+        "SMAPI_CLIENT_SECRET": "your-secret",
+        "SMAPI_SCOPE": "your-scope",
+        "SMAPI_CONTRACT_ID": "your-contract-id"
+      }
+    }
+  }
+}
+```
+
+### Smithery
+
+Install via [Smithery](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp):
+
+```bash
+npx @smithery/cli mcp add fabsforward2-zhoi/sbb-mcp
+```
+
+### Demo Mode (No Credentials)
+
+Run without any environment variables to use mock data:
+
+```bash
+npx sbb-mcp
+```
+
+This lets you test the MCP server with realistic Swiss station data without SBB API credentials.
+
+## Tools
+
+### search_stations
+
+Search for Swiss train stations by name. Returns station IDs needed for other tools.
+
+**Input:**
+- `query` (string, required) -- Station name, e.g. "Zurich", "Bern", "Interlaken"
+- `limit` (number, optional) -- Max results (default: 10)
+
+**Example:** "Find stations matching Luzern"
+
+### search_connections
+
+Find train connections between two stations. Automatically resolves station names to IDs.
+
+**Input:**
+- `from` (string, required) -- Origin station name or ID (e.g. "Zurich HB" or "8503000")
+- `to` (string, required) -- Destination station name or ID
+- `date` (string, optional) -- Travel date YYYY-MM-DD
+- `time` (string, optional) -- Departure time HH:MM
+- `arrival_time` (boolean, optional) -- Treat time as arrival time
+
+**Example:** "Show me trains from Zurich to Bern tomorrow at 9am"
+
+### get_trip_details
+
+Get detailed stop-by-stop information for a connection including intermediate stops, platforms, and occupancy forecasts.
+
+**Input:**
+- `trip_id` (string, required) -- Trip ID from search_connections
+
+### get_more_connections
+
+Load earlier or later trains for a previous search.
+
+**Input:**
+- `collection_id` (string, required) -- Collection ID from search_connections
+- `direction` ("next" | "previous") -- Later or earlier trains
+
+### get_prices
+
+Get ticket prices with Swiss reduction card support. Supports multi-traveler family pricing when connected to SwissTrip.
+
+**Input:**
+- `trip_ids` (string[], required) -- Trip IDs from search_connections
+- `traveler_type` ("ADULT" | "CHILD", default: "ADULT") -- used when no traveler_names given
+- `reduction_card` ("HALF_FARE" | "GA" | "NONE", default: "HALF_FARE") -- used when no traveler_names given
+- `traveler_names` (string[], optional) -- SwissTrip traveler names for family pricing (requires `SWISSTRIP_TOKEN`)
+
+**Example:** "How much for Zurich to Zermatt for Fabian and Anna?" (with SwissTrip connected, each traveler's reduction card is applied automatically)
+
+### get_ticket_link
+
+Get a direct purchase link to buy the ticket on SBB.ch. On mobile with the SBB app installed, opens directly in the app with Halbtax/GA applied automatically. Supports multi-traveler tickets when connected to SwissTrip.
+
+**Input:**
+- `trip_id` (string, required) -- Trip ID to purchase
+- `from_name` (string, required) -- Origin station name
+- `from_id` (string, required) -- Origin station ID
+- `to_name` (string, required) -- Destination station name
+- `to_id` (string, required) -- Destination station ID
+- `date` (string, required) -- Travel date YYYY-MM-DD
+- `time` (string, required) -- Departure time HH:MM
+- `traveler_type` ("ADULT" | "CHILD", default: "ADULT") -- used when no traveler_names given
+- `reduction_card` ("HALF_FARE" | "GA" | "NONE", default: "HALF_FARE") -- used when no traveler_names given
+- `traveler_names` (string[], optional) -- SwissTrip traveler names for family tickets (requires `SWISSTRIP_TOKEN`)
+
+### list_travelers
+
+List all travelers in the user's SwissTrip account (self, partner, kids). Each traveler has their own reduction card. Requires `SWISSTRIP_TOKEN`.
+
+**Example:** "Who are my travelers?" → shows all saved travelers with their reduction cards
+
+## Prompts
+
+### plan_journey
+
+End-to-end journey planning prompt. Searches connections, compares prices, and provides ticket links.
+
+**Input:**
+- `from` (string, required) -- Origin station
+- `to` (string, required) -- Destination station
+- `date` (string, optional) -- Travel date
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `SMAPI_CLIENT_ID` | Yes* | OAuth 2.0 client ID from SBB Developer Portal |
+| `SMAPI_CLIENT_SECRET` | Yes* | OAuth 2.0 client secret |
+| `SMAPI_SCOPE` | Yes* | OAuth scope |
+| `SMAPI_CONTRACT_ID` | Yes* | SBB business contract ID |
+| `SMAPI_ENV` | No | `int` (default) or `prod` |
+| `SMAPI_TENANT_ID` | No | Azure AD tenant (defaults to SBB tenant) |
+| `SWISSTRIP_TOKEN` | No | SwissTrip auth token for cloud profiles and multi-traveler support |
+| `SWISSTRIP_URL` | No | SwissTrip API base URL (defaults to `https://swisstrip.ch`) |
+
+*Without SMAPI credentials, the server runs in mock mode with realistic demo data.
+
+## SwissTrip Integration (Optional)
+
+Set `SWISSTRIP_TOKEN` to connect sbb-mcp to your [SwissTrip](https://swisstrip.ch) account. This enables:
+
+- **Cloud-synced profiles** -- your travel profile (name, DOB, reduction card) syncs from SwissTrip instead of local `~/.sbb-mcp/profile.json`
+- **Multi-traveler pricing** -- add your partner, kids, or travel companions on SwissTrip and get per-person pricing with correct reduction cards
+- **Family tickets** -- pass `traveler_names` to `get_prices` and `get_ticket_link` for group pricing
+
+```json
+{
+  "mcpServers": {
+    "sbb": {
+      "command": "npx",
+      "args": ["-y", "sbb-mcp"],
+      "env": {
+        "SMAPI_CLIENT_ID": "your-client-id",
+        "SMAPI_CLIENT_SECRET": "your-secret",
+        "SMAPI_SCOPE": "your-scope",
+        "SWISSTRIP_TOKEN": "your-swisstrip-auth-token"
+      }
+    }
+  }
+}
+```
+
+Without `SWISSTRIP_TOKEN`, sbb-mcp uses local file-based profiles as before -- no SwissTrip account required.
+
+## Available on
+
+- [npm](https://www.npmjs.com/package/sbb-mcp)
+- [Official MCP Registry](https://registry.modelcontextprotocol.io)
+- [Smithery](https://smithery.ai/servers/fabsforward2-zhoi/sbb-mcp)
+
+Also available as: [sbb-mcp-official](https://www.npmjs.com/package/sbb-mcp-official) | [swiss-rail-mcp](https://www.npmjs.com/package/swiss-rail-mcp) | [sbb-cff-ffs-mcp](https://www.npmjs.com/package/sbb-cff-ffs-mcp) | [swiss-train-mcp](https://www.npmjs.com/package/swiss-train-mcp) | [swiss-railways-mcp](https://www.npmjs.com/package/swiss-railways-mcp)
+
+## About
+
+Built on the official SBB Swiss Mobility API (SMAPI) with OSDM-compliant journey planning and pricing. Covers the entire Swiss public transport network including SBB, BLS, SOB, and regional operators.
+
+**SBB** (Schweizerische Bundesbahnen) / **CFF** (Chemins de fer federaux suisses) / **FFS** (Ferrovie federali svizzere) -- Swiss Federal Railways operates one of the densest rail networks in the world with over 10,000 daily connections.
+
+## License
+
+[FSL-1.1-MIT](https://fsl.software/) -- Functional Source License. Free to use for any non-competing purpose. Converts to MIT after 2 years. See [LICENSE](LICENSE) for details.

package/dist/auth.d.ts

@@ -0,0 +1,2 @@
+export declare function isSmapiConfigured(): boolean;
+export declare function getAccessToken(): Promise<string>;