io.github.srivastsh/muni-mcp

Official11 tools

by srivastsh · TypeScript

SF Muni Real-Time Transit

Real-time SF Muni departures, routes, alerts, vehicle positions, and schedules.

Real-time SF Muni transit departures, routes, alerts, and vehicle tracking.

Captured live from the server via tools/list.

transit_operators

List all transit operators available in the 511 API (BART, Muni, Caltrain, AC Transit, etc.).

No parameters.

muni_routes

List all SF Muni routes (bus, rail, cable car). Args: - operator_id: Optional operator ID (default 'SF' for Muni)

Parameters (1)

operator_idstring
Operator ID (default SF)

muni_stop_search

Search Muni stops by stop name, stop code, or route. Use this before muni_departures if you do not know the stop code.

Parameters (4)

querystringrequired
Stop name, intersection, or stop code, e.g. Duboce, Van Ness, 15731
line_idstring
Optional route/line filter, e.g. N, 14, 38R
operator_idstring
Operator ID (default SF)
limitinteger
Maximum matches to return

muni_nearby_stops

Find Muni stops near a latitude/longitude point.

Parameters (5)

latitudenumberrequired
Latitude
longitudenumberrequired
Longitude
radius_milesnumber
Search radius in miles
operator_idstring
Operator ID (default SF)
limitinteger
Maximum stops to return

muni_departures

Get real-time departure predictions for a Muni stop. Args: - stop_code: The 5-digit stop code - operator_id: Optional (default 'SF')

Parameters (2)

stop_codestringrequired
Muni stop code (e.g. '15731')
operator_idstring
Operator ID (default SF)

muni_departures_by_route_stop

Get real-time departures at a stop filtered to one Muni route/line.

Parameters (3)

stop_codestringrequired
Muni stop code
line_idstringrequired
Route/line ID, e.g. N, 14, 38R
operator_idstring
Operator ID (default SF)

muni_line

Get details for a specific Muni line including stops. Args: - line_id: Route/line ID (e.g. 'N', '14', '38R') - operator_id: Optional (default 'SF')

Parameters (2)

line_idstringrequired
Muni line/route ID
operator_idstring
Operator ID (default SF)

muni_alerts

Get current Muni service alerts, detours, and disruptions. Args: - operator_id: Optional (default 'SF')

Parameters (1)

operator_idstring
Operator ID (default SF)

muni_status_summary

Summarize current Muni service status from 511 service alerts.

Parameters (1)

operator_idstring
Operator ID (default SF)

muni_vehicles

Get real-time GPS positions of Muni vehicles. Args: - operator_id: Optional (default 'SF')

Parameters (1)

operator_idstring
Operator ID (default SF)

muni_schedule

Get the timetable/schedule for a specific Muni line. Args: - line_id: Route/line ID (e.g. 'N', '14', '38R') - operator_id: Optional (default 'SF')

Parameters (2)

line_idstringrequired
Muni line/route ID
operator_idstring
Operator ID (default SF)

README.md4 KBView on GitHub

Bay Area Transit MCP Servers

Two Cloudflare Workers providing MCP (Model Context Protocol) access to BART and SF Muni real-time transit data. Works with Claude, ChatGPT, Poke, Cursor, and any MCP-compatible client.

You don't need to deploy anything. Just point your MCP client at the hosted endpoints below.

Live Endpoints

BART: https://bart-mcp.srivastsh.workers.dev/mcp — no auth, just connect
Muni: https://muni-mcp.srivastsh.workers.dev/mcp — pass your free 511.org API key via x-api-key-511 header

These run on Cloudflare Workers' free tier (100k requests/day). Since the Muni server uses BYOK auth, each user's 511 rate limit is isolated to their own key.

Quick Start

BART (no auth required)

Just add the URL to your MCP client. No API key needed.

Muni (BYOK)

Get a free 511.org API key at https://511.org/open-data/token
Pass it via the x-api-key-511 header in your MCP config

Client Configuration

Claude Desktop / Claude Code

json

{
  "mcpServers": {
    "bart": {
      "url": "https://bart-mcp.srivastsh.workers.dev/mcp"
    },
    "muni": {
      "url": "https://muni-mcp.srivastsh.workers.dev/mcp",
      "headers": {
        "x-api-key-511": "YOUR_511_API_KEY"
      }
    }
  }
}

Poke

One-click setup: BART recipe | Muni recipe

Or add manually as a remote MCP server:

URL: https://bart-mcp.srivastsh.workers.dev/mcp or https://muni-mcp.srivastsh.workers.dev/mcp
For Muni, set custom header x-api-key-511 to your 511 key

Cursor / Windsurf / stdio-only Clients

Use mcp-remote as a bridge:

json

{
  "mcpServers": {
    "bart": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote", "https://bart-mcp.srivastsh.workers.dev/mcp"]
    },
    "muni": {
      "command": "npx",
      "args": [
        "-y", "@anthropic-ai/mcp-remote",
        "https://muni-mcp.srivastsh.workers.dev/mcp",
        "--header", "x-api-key-511:YOUR_511_API_KEY"
      ]
    }
  }
}

Available Tools

BART (5 tools)

Tool	Description
`bart_stations`	List all BART stations with codes
`bart_departures`	Real-time departures from a station
`bart_trip`	Plan a trip between two stations
`bart_advisories`	Current service advisories
`bart_fare`	Fare lookup between two stations

Muni (7 tools)

Tool	Description
`transit_operators`	List all 511 transit operators
`muni_routes`	List all Muni routes
`muni_departures`	Real-time departures from a stop
`muni_line`	Line details with stops
`muni_alerts`	Current service alerts
`muni_vehicles`	Real-time vehicle GPS positions
`muni_schedule`	Timetable for a line

Deploy Your Own

Most users don't need to deploy — just use the hosted endpoints above. But if you want your own instance:

Prerequisites

Node.js 18+
Cloudflare account (free tier works)
wrangler CLI: npm install -g wrangler

BART Worker

bash

cd bart-mcp
npm install
wrangler login
wrangler deploy

The public BART demo key (MW9S-E7SL-26DU-VV8V) is baked into wrangler.toml. No secrets needed.

Muni Worker

bash

cd muni-mcp
npm install
wrangler deploy

Optionally set a fallback 511 key (used when no header key is provided):

bash

wrangler secret put API_511_KEY

Architecture

Runtime: Cloudflare Workers (V8 isolates)
Transport: WebStandardStreamableHTTPServerTransport (stateless, one server per request)
Auth: BYOK via request headers, optional env secret fallback
Validation: Zod schemas for all tool inputs
CORS: Enabled for all origins
API Sources: api.bart.gov (BART), api.511.org (Muni/511)

Install

claude_desktop_config.json

{
  "mcpServers": {
    "muni-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://muni-mcp.srivastsh.workers.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.