MBTA Worcester Line

This MCP server provides real-time MBTA Worcester Line train departures by merging scheduled times with live predictions for all 18 stops. You can query departures from any Worcester Line station through compatible MCP clients and keep your displays or automation up to date with current transit information.

How to use

You can access the MBTA Worcester Line MCP Server from MCP clients such as Gemini CLI or Claude Desktop. Use it to retrieve upcoming departures for a specific stop and optionally filter by direction, date, and limit. The server exposes two connection methods: a remote HTTP endpoint and a local stdio-based client setup you can run on your machine.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

# Install project dependencies
npm install

# Create local environment file and add your MBTA API key
cp .env.example .env.local

Additional configuration and usage notes

Environment variables you need to provide for local or deployment use are the MBTA API key and an optional MCP API key used for client authentication.

Deployment prompts show how to supply required keys to enable live data feeds and secure access when consuming the MCP server from clients.

Run the development server locally to verify everything is wired correctly.

Deployment

Deploy to a hosting platform that supports Next.js apps. The configuration requires the MBTA API key and, optionally, a secret token for MCP client authentication.

Client setup examples

Gemini CLI and Claude Desktop are supported MCP clients. You configure them to point at the server and to pass authentication tokens when needed.

Available tools

get_worcester_departures

Fetch upcoming departures from a specified Worcester Line stop, with optional direction, date, and limit parameters.