ojp-mcp

MCP server for Swiss public transport, backed by the OJP 2.0 API of opentransportdata.swiss. Runs locally over stdio with your own API token.

Proof of concept. This project is not actively maintained. Feel free to reuse and fork it under the MIT license.

Token

1. Register at https://api-manager.opentransportdata.swiss.

2. Subscribe to the OJP 2.0 API and copy your token.

3. Pass it as OJP_TOKEN (environment only; it never appears in tool output or logs).

Related MCP server: Zügli MCP Server

Setup

Requires Node ≥ 20.

git clone https://github.com/d3orn/ojp-mcp.git
cd ojp-mcp
npm install

Claude Code:

claude mcp add ojp -e OJP_TOKEN=<your-token> -- node /absolute/path/to/ojp-mcp/src/index.js

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "ojp": {
      "command": "node",
      "args": ["/absolute/path/to/ojp-mcp/src/index.js"],
      "env": { "OJP_TOKEN": "<your-token>" }
    }
  }
}

Not yet published to npm. Once it is, npx -y ojp-mcp replaces node /absolute/path/to/ojp-mcp/src/index.js.

Tools

Places accept a name or an id from search_locations; ambiguous names return candidate ids instead of guessing. Times are Europe/Zurich (input without offset is local time). All tools take language (de default, fr, it, en).

Limits & errors

The OJP API allows 50 calls per minute and 20 000 calls per day per token. Most tools use 1 call. plan_trip uses 1 more for each place given as a name, so up to 4. Pass ids from search_locations to save calls.

Development

npm install
npm test

License

MIT