gtfs-pro-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+Copyright (C) Digital Mountaineers
+
+This program is free software; you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation; either version 2 of the License, or (at your option) any later
+version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with
+this program; if not, see <https://www.gnu.org/licenses/gpl-2.0.html>.
+
+SPDX-License-Identifier: GPL-2.0-or-later

package/README.md

@@ -0,0 +1,121 @@
+# gtfs-pro-mcp
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that turns any
+[WP GTFS Pro](https://devbydm.com) transit site into a set of tools for AI
+assistants. Point it at an agency's WordPress site and Claude, ChatGPT, or any
+other MCP-compatible client can answer rider questions from the agency's **live**
+GTFS and GTFS-Realtime data — nearest stops, next departures, routes, live bus
+positions, and service alerts.
+
+It talks to the site's public REST API (`/wp-json/wp-gtfs-pro/v1/*`) — no plugins,
+no database access, no credentials required. One MCP server covers one transit site
+(which may host multiple agency feeds).
+
+> **Why this exists:** the only other transit MCP servers are single-agency,
+> hard-coded hobby projects. This one works with *any* GTFS Pro install, driven
+> entirely by configuration.
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `list_feeds` | List the transit feeds (agencies) configured on the site |
+| `find_nearby_stops` | Nearest stops to a lat/lon, with serving routes and next departures |
+| `search_stops` | Find stops by name, landmark, or stop code |
+| `get_stop_departures` | Next departures from a specific stop, across all routes |
+| `get_route_map` | A route's shape (path geometry) and the stops it serves |
+| `get_system_map` | Every route in the system with its stops |
+| `get_service_alerts` | Active GTFS-Realtime service alerts (empty = no active alerts) |
+| `get_live_vehicles` | Real-time vehicle positions (empty = none reporting right now) |
+| `geocode_address` | Address / place name → coordinates, biased to the service area |
+
+The realtime tools (`get_service_alerts`, `get_live_vehicles`) **never error on
+missing data** — an empty result means "nothing active right now," not "no
+service." The tool descriptions tell the AI this explicitly.
+
+## Requirements
+
+- Node.js 18 or newer
+- A transit website running WP GTFS Pro 1.5+ with its REST API publicly reachable
+
+## Configuration
+
+Provide settings via a JSON config file **or** environment variables (env vars win
+where both are set). Only the site URL is required.
+
+```jsonc
+// gtfs-pro.config.json
+{
+  "gtfs_pro_url": "https://your-agency-site.org",
+  "feed_id": "default",
+  "cache_ttl_seconds": 30,
+  "agency_name": "Your Transit Agency",
+  "agency_description": "Public transit serving ... (cities, landmarks, region)."
+}
+```
+
+| Setting | Env var | Default | Notes |
+|---------|---------|---------|-------|
+| `gtfs_pro_url` | `GTFS_PRO_URL` | — (required) | Base URL of the WP GTFS Pro site |
+| `feed_id` | `GTFS_PRO_FEED_ID` | `default` | Default feed so the AI needn't pass one each call |
+| `cache_ttl_seconds` | `GTFS_PRO_CACHE_TTL` | `30` | Local response cache; protects the WP site |
+| `agency_name` | `GTFS_PRO_AGENCY_NAME` | — | Shown in server metadata |
+| `agency_description` | `GTFS_PRO_AGENCY_DESCRIPTION` | — | Service-area context for the AI |
+
+Pass a non-default config path with `--config /path/to/config.json` or the
+`GTFS_PRO_CONFIG` env var.
+
+## Use with Claude Desktop
+
+Edit `claude_desktop_config.json` (Settings → Developer → Edit Config) and add:
+
+```json
+{
+  "mcpServers": {
+    "gtfs-pro-transit": {
+      "command": "npx",
+      "args": ["-y", "gtfs-pro-mcp"],
+      "env": {
+        "GTFS_PRO_URL": "https://your-agency-site.org",
+        "GTFS_PRO_FEED_ID": "default",
+        "GTFS_PRO_AGENCY_NAME": "Your Transit Agency"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop, then ask: *"What bus stops are near \<a place in the
+service area\>?"* or *"When's the next bus from \<stop name\>?"*
+
+## Use with ChatGPT / other MCP clients
+
+Any client that launches a local stdio MCP server works the same way — run
+`npx -y gtfs-pro-mcp` with the same environment variables, or install globally:
+
+```bash
+npm install -g gtfs-pro-mcp
+GTFS_PRO_URL=https://your-agency-site.org gtfs-pro-mcp
+```
+
+## Local development
+
+```bash
+npm install
+npm run build       # compile TypeScript to dist/
+node test/smoke.mjs # exercise all 9 tools against a live site
+```
+
+## How it fits together
+
+```
+AI assistant  ──MCP/stdio──►  gtfs-pro-mcp  ──HTTPS──►  WP GTFS Pro REST API
+(Claude, GPT)                 (this package)            /wp-json/wp-gtfs-pro/v1/*
+```
+
+A future release adds a Streamable-HTTP transport so the server can run as a
+hosted remote service (one endpoint per agency) instead of a local process.
+
+## License
+
+GPL-2.0-or-later © Digital Mountaineers

package/dist/api-client.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Thin HTTP client for the WP GTFS Pro REST API.
+ *
+ * Responsibilities:
+ *  - Build namespaced URLs and inject the default feed_id.
+ *  - Cache GET responses in-process for `cacheTtlSeconds` (spec §1.9: keep it to
+ *    ~1 call per 30s per unique query so we never hammer the agency's WP site).
+ *  - Turn failures into human-readable messages (spec §1.6) rather than leaking
+ *    raw JSON or stack traces to the AI.
+ */
+import type { Config } from "./config.js";
+/** A failure we want the AI to read as prose (not a thrown stack trace). */
+export declare class GtfsApiError extends Error {
+    constructor(message: string);
+}
+export declare class ApiClient {
+    private readonly config;
+    private readonly base;
+    private readonly cache;
+    constructor(config: Config);
+    /** The configured default feed, used when a tool call omits feed_id. */
+    get defaultFeedId(): string;
+    /**
+     * GET a REST path with query params. Empty/undefined params are dropped.
+     * Results are cached by full URL for the configured TTL.
+     */
+    get<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+    /**
+     * Convert a non-2xx response into a readable sentence. WordPress REST errors
+     * carry `{ code, message }`; surface the message when present.
+     */
+    private describeError;
+}

package/dist/api-client.js

@@ -0,0 +1,99 @@
+/**
+ * Thin HTTP client for the WP GTFS Pro REST API.
+ *
+ * Responsibilities:
+ *  - Build namespaced URLs and inject the default feed_id.
+ *  - Cache GET responses in-process for `cacheTtlSeconds` (spec §1.9: keep it to
+ *    ~1 call per 30s per unique query so we never hammer the agency's WP site).
+ *  - Turn failures into human-readable messages (spec §1.6) rather than leaking
+ *    raw JSON or stack traces to the AI.
+ */
+/** A failure we want the AI to read as prose (not a thrown stack trace). */
+export class GtfsApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GtfsApiError";
+    }
+}
+export class ApiClient {
+    config;
+    base;
+    cache = new Map();
+    constructor(config) {
+        this.config = config;
+        this.base = `${config.gtfsProUrl}/wp-json/wp-gtfs-pro/v1`;
+    }
+    /** The configured default feed, used when a tool call omits feed_id. */
+    get defaultFeedId() {
+        return this.config.feedId;
+    }
+    /**
+     * GET a REST path with query params. Empty/undefined params are dropped.
+     * Results are cached by full URL for the configured TTL.
+     */
+    async get(path, params = {}) {
+        const url = new URL(this.base + path);
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === "")
+                continue;
+            url.searchParams.set(key, String(value));
+        }
+        const href = url.toString();
+        const now = Date.now();
+        const hit = this.cache.get(href);
+        if (hit && hit.expires > now) {
+            return hit.data;
+        }
+        let res;
+        try {
+            res = await fetch(href, {
+                headers: { Accept: "application/json", "User-Agent": "gtfs-pro-mcp" },
+            });
+        }
+        catch {
+            // Network-level failure: the WP site is unreachable. Spec §1.6 exact intent.
+            throw new GtfsApiError(`The transit data service at ${this.config.gtfsProUrl} is currently ` +
+                `unavailable. The rider should check the agency website directly.`);
+        }
+        const text = await res.text();
+        let parsed;
+        try {
+            parsed = text ? JSON.parse(text) : null;
+        }
+        catch {
+            parsed = null;
+        }
+        if (!res.ok) {
+            throw new GtfsApiError(this.describeError(res.status, parsed));
+        }
+        const ttlMs = this.config.cacheTtlSeconds * 1000;
+        if (ttlMs > 0) {
+            this.cache.set(href, { expires: now + ttlMs, data: parsed });
+        }
+        return parsed;
+    }
+    /**
+     * Convert a non-2xx response into a readable sentence. WordPress REST errors
+     * carry `{ code, message }`; surface the message when present.
+     */
+    describeError(status, body) {
+        const wpMessage = body && typeof body === "object" && "message" in body
+            ? String(body.message)
+            : "";
+        if (status === 404) {
+            return wpMessage
+                ? `Not found: ${wpMessage}`
+                : "That transit record was not found. Double-check the stop or route id.";
+        }
+        if (status === 400) {
+            return wpMessage
+                ? `Invalid request: ${wpMessage}`
+                : "The request was invalid. Check the parameters and try again.";
+        }
+        if (wpMessage) {
+            return `The transit data service returned an error (${status}): ${wpMessage}`;
+        }
+        return `The transit data service returned an unexpected error (HTTP ${status}).`;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Configuration loader for the GTFS Pro MCP server.
+ *
+ * Resolution order (later wins where they overlap):
+ *   1. A JSON config file — path from `--config <path>`, else $GTFS_PRO_CONFIG,
+ *      else ./gtfs-pro.config.json if it exists.
+ *   2. Environment variables (GTFS_PRO_URL, GTFS_PRO_FEED_ID, ...).
+ *
+ * Only `gtfs_pro_url` is strictly required. Everything else has a sane default
+ * so a single-agency setup can run with just the URL.
+ */
+export interface Config {
+    /** Base URL of the WordPress site running WP GTFS Pro (no trailing slash). */
+    gtfsProUrl: string;
+    /** Default feed to use when the AI doesn't specify one. */
+    feedId: string;
+    /** Local response cache lifetime, in seconds (protects the WP site). */
+    cacheTtlSeconds: number;
+    /** Human label for the agency this server covers (used in server metadata). */
+    agencyName: string;
+    /** Free-text description of the agency's service area (used in metadata). */
+    agencyDescription: string;
+}
+export declare function loadConfig(): Config;

package/dist/config.js

@@ -0,0 +1,56 @@
+/**
+ * Configuration loader for the GTFS Pro MCP server.
+ *
+ * Resolution order (later wins where they overlap):
+ *   1. A JSON config file — path from `--config <path>`, else $GTFS_PRO_CONFIG,
+ *      else ./gtfs-pro.config.json if it exists.
+ *   2. Environment variables (GTFS_PRO_URL, GTFS_PRO_FEED_ID, ...).
+ *
+ * Only `gtfs_pro_url` is strictly required. Everything else has a sane default
+ * so a single-agency setup can run with just the URL.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+function readConfigFile() {
+    // --config <path> takes precedence, then $GTFS_PRO_CONFIG, then a local default.
+    const argIdx = process.argv.indexOf("--config");
+    const fromArg = argIdx !== -1 && process.argv[argIdx + 1] ? process.argv[argIdx + 1] : undefined;
+    const candidate = fromArg ||
+        process.env.GTFS_PRO_CONFIG ||
+        (existsSync("gtfs-pro.config.json") ? "gtfs-pro.config.json" : undefined);
+    if (!candidate)
+        return {};
+    const path = resolve(candidate);
+    if (!existsSync(path)) {
+        throw new Error(`Config file not found: ${path}`);
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (err) {
+        throw new Error(`Could not parse config file ${path}: ${err.message}`);
+    }
+}
+export function loadConfig() {
+    const file = readConfigFile();
+    const gtfsProUrl = (process.env.GTFS_PRO_URL || file.gtfs_pro_url || "").trim();
+    if (!gtfsProUrl) {
+        throw new Error("Missing GTFS Pro site URL. Set `gtfs_pro_url` in your config file or the " +
+            "GTFS_PRO_URL environment variable (e.g. https://your-agency-site.org).");
+    }
+    const ttlRaw = process.env.GTFS_PRO_CACHE_TTL ?? file.cache_ttl_seconds;
+    const cacheTtlSeconds = Number.isFinite(Number(ttlRaw)) ? Number(ttlRaw) : 30;
+    return {
+        // Strip any trailing slash so we can concatenate the REST namespace cleanly.
+        gtfsProUrl: gtfsProUrl.replace(/\/+$/, ""),
+        feedId: (process.env.GTFS_PRO_FEED_ID || file.feed_id || "default").trim(),
+        cacheTtlSeconds: cacheTtlSeconds >= 0 ? cacheTtlSeconds : 30,
+        agencyName: (process.env.GTFS_PRO_AGENCY_NAME ||
+            file.agency_name ||
+            "this transit agency").trim(),
+        agencyDescription: (process.env.GTFS_PRO_AGENCY_DESCRIPTION ||
+            file.agency_description ||
+            "").trim(),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,SAAS,cAAc;IACrB,iFAAiF;IACjF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,OAAO,GACX,MAAM,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,MAAM,SAAS,GACb,OAAO;QACP,OAAO,CAAC,GAAG,CAAC,eAAe;QAC3B,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE5E,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAkB,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CACjE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAE9B,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,2EAA2E;YACzE,wEAAwE,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,iBAAiB,CAAC;IACxE,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9E,OAAO;QACL,6EAA6E;QAC7E,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,IAAI,EAAE;QAC1E,eAAe,EAAE,eAAe,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE;QAC5D,UAAU,EAAE,CACV,OAAO,CAAC,GAAG,CAAC,oBAAoB;YAChC,IAAI,CAAC,WAAW;YAChB,qBAAqB,CACtB,CAAC,IAAI,EAAE;QACR,iBAAiB,EAAE,CACjB,OAAO,CAAC,GAAG,CAAC,2BAA2B;YACvC,IAAI,CAAC,kBAAkB;YACvB,EAAE,CACH,CAAC,IAAI,EAAE;KACT,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * GTFS Pro MCP server — entry point.
+ *
+ * Loads configuration, builds the API client, registers the nine transit tools,
+ * and speaks MCP over stdio (the transport Claude Desktop / ChatGPT desktop use
+ * to launch a local server). All diagnostics go to stderr so they never corrupt
+ * the stdout JSON-RPC stream.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * GTFS Pro MCP server — entry point.
+ *
+ * Loads configuration, builds the API client, registers the nine transit tools,
+ * and speaks MCP over stdio (the transport Claude Desktop / ChatGPT desktop use
+ * to launch a local server). All diagnostics go to stderr so they never corrupt
+ * the stdout JSON-RPC stream.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { ApiClient } from "./api-client.js";
+import { registerTools } from "./tools.js";
+async function main() {
+    const config = loadConfig();
+    const api = new ApiClient(config);
+    const instructions = `This server provides real-time transit information for ${config.agencyName}.` +
+        (config.agencyDescription ? ` ${config.agencyDescription}` : "") +
+        ` Use the tools to look up bus stops, schedules, routes, live vehicle positions, ` +
+        `and service alerts. Always use the tools for schedule and stop data — never guess ` +
+        `times. Note: realtime tools (get_service_alerts, get_live_vehicles) returning an ` +
+        `empty result is normal and means "nothing active right now," not "no service."`;
+    const server = new McpServer({ name: "gtfs-pro-transit", version: "1.0.0" }, { instructions });
+    registerTools(server, api);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Visible in the client's MCP logs; harmless on stderr.
+    console.error(`gtfs-pro-mcp ready — agency: ${config.agencyName}, site: ${config.gtfsProUrl}, ` +
+        `default feed: ${config.feedId}`);
+}
+main().catch((err) => {
+    console.error(`gtfs-pro-mcp failed to start: ${err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAElC,MAAM,YAAY,GAChB,0DAA0D,MAAM,CAAC,UAAU,GAAG;QAC9E,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,kFAAkF;QAClF,oFAAoF;QACpF,mFAAmF;QACnF,gFAAgF,CAAC;IAEnF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,CACjB,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,wDAAwD;IACxD,OAAO,CAAC,KAAK,CACX,gCAAgC,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,UAAU,IAAI;QAC/E,iBAAiB,MAAM,CAAC,MAAM,EAAE,CACnC,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,iCAAkC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The nine GTFS Pro MCP tools. Each wraps one REST endpoint, formats the result
+ * as readable text (IDs included so the AI can chain calls), and surfaces failures
+ * as prose. Tool descriptions are written for the *model* — they spell out when an
+ * empty result is normal so the AI never reads "no alerts" as "no service."
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ApiClient } from "./api-client.js";
+export declare function registerTools(server: McpServer, api: ApiClient): void;

package/dist/tools.js

@@ -0,0 +1,301 @@
+/**
+ * The nine GTFS Pro MCP tools. Each wraps one REST endpoint, formats the result
+ * as readable text (IDs included so the AI can chain calls), and surfaces failures
+ * as prose. Tool descriptions are written for the *model* — they spell out when an
+ * empty result is normal so the AI never reads "no alerts" as "no service."
+ */
+import { z } from "zod";
+import { GtfsApiError } from "./api-client.js";
+/* ----------------------------- GTFS-RT enum maps ----------------------------- */
+// https://gtfs.org/realtime/reference/ — surface human labels, never raw integers.
+const CAUSE = {
+    1: "Unknown cause", 2: "Other cause", 3: "Technical problem", 4: "Strike",
+    5: "Demonstration", 6: "Accident", 7: "Holiday", 8: "Weather",
+    9: "Maintenance", 10: "Construction", 11: "Police activity", 12: "Medical emergency",
+};
+const EFFECT = {
+    1: "No service", 2: "Reduced service", 3: "Significant delays", 4: "Detour",
+    5: "Additional service", 6: "Modified service", 7: "Other effect",
+    8: "Unknown effect", 9: "Stop moved", 10: "No effect", 11: "Accessibility issue",
+};
+const SEVERITY = {
+    1: "Unknown severity", 2: "Info", 3: "Warning", 4: "Severe",
+};
+/* --------------------------------- helpers ---------------------------------- */
+const text = (s) => ({ content: [{ type: "text", text: s }] });
+const errText = (s) => ({
+    content: [{ type: "text", text: s }],
+    isError: true,
+});
+/** Run a tool body, converting GtfsApiError into a visible (isError) tool result. */
+async function guard(run) {
+    try {
+        return await run();
+    }
+    catch (err) {
+        if (err instanceof GtfsApiError)
+            return errText(err.message);
+        return errText(`Something went wrong reaching the transit data service: ${err.message}`);
+    }
+}
+const fmtCoord = (n) => n.toFixed(5);
+/* --------------------------------- tools ------------------------------------ */
+export function registerTools(server, api) {
+    const feedArg = {
+        feed_id: z
+            .string()
+            .optional()
+            .describe(`Feed identifier for multi-agency sites. Defaults to "${api.defaultFeedId}". ` +
+            `Call list_feeds first if unsure which feeds exist.`),
+    };
+    const feed = (id) => id || api.defaultFeedId;
+    /* 1. list_feeds */
+    server.registerTool("list_feeds", {
+        title: "List transit feeds",
+        description: "List all transit feeds (agencies) configured on this GTFS Pro site. Most " +
+            "sites have a single feed. Use this to discover feed_id values when a site " +
+            "serves more than one agency.",
+        inputSchema: {},
+    }, () => guard(async () => {
+        const feeds = await api.get("/feeds");
+        if (!feeds.length)
+            return text("No transit feeds are configured on this site.");
+        const lines = feeds.map((f) => `• ${f.name} — feed_id: "${f.id}"${f.active ? "" : " (inactive)"}` +
+            (f.url ? `\n  GTFS source: ${f.url}` : ""));
+        return text(`Configured transit feeds:\n${lines.join("\n")}`);
+    }));
+    /* 2. find_nearby_stops */
+    server.registerTool("find_nearby_stops", {
+        title: "Find nearby stops",
+        description: "Find the nearest transit stops to a latitude/longitude. Returns each stop " +
+            "with its distance, the routes that serve it, and the next scheduled " +
+            "departure times per route. If you only have an address or place name, call " +
+            "geocode_address first to get coordinates.",
+        inputSchema: {
+            latitude: z.number().min(-90).max(90).describe("Latitude (-90 to 90)."),
+            longitude: z.number().min(-180).max(180).describe("Longitude (-180 to 180)."),
+            radius_meters: z
+                .number()
+                .int()
+                .positive()
+                .max(5000)
+                .optional()
+                .describe("Search radius in meters (default 800, max 5000)."),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(10)
+                .optional()
+                .describe("Max stops to return (default 5, max 10)."),
+            ...feedArg,
+        },
+    }, (args) => guard(async () => {
+        const data = await api.get("/stops/nearby", {
+            lat: args.latitude,
+            lon: args.longitude,
+            radius: args.radius_meters ?? 800,
+            limit: args.limit ?? 5,
+            feed_id: feed(args.feed_id),
+        });
+        if (!data.stops?.length) {
+            return text("No transit stops were found within the search radius. Try a larger " +
+                "radius_meters, or confirm the coordinates are inside the agency's service area.");
+        }
+        const blocks = data.stops.map((s) => {
+            const head = `${s.name} (stop_id: ${s.id}${s.code ? `, code ${s.code}` : ""}) — ${s.distance_text}`;
+            const routes = s.routes.length
+                ? s.routes
+                    .map((r) => {
+                    const next = r.next.length ? r.next.join(", ") : "no upcoming scheduled departures";
+                    return `    - Route ${r.name} (route_id: ${r.route_id}): ${next}`;
+                })
+                    .join("\n")
+                : "    - No routes currently scheduled here.";
+            return `${head}\n${routes}`;
+        });
+        return text(`Nearest stops:\n${blocks.join("\n")}`);
+    }));
+    /* 3. search_stops */
+    server.registerTool("search_stops", {
+        title: "Search stops by name",
+        description: "Search for transit stops by name, landmark, or stop code. Use this when the " +
+            "rider names a place (\"Big Bear Village\", \"Goodwin's Market\") rather than " +
+            "giving coordinates. Returns matching stops with their stop_id, which you can " +
+            "pass to get_stop_departures.",
+        inputSchema: {
+            query: z.string().min(2).describe("Stop name, landmark, or stop code (min 2 chars)."),
+            limit: z.number().int().positive().max(12).optional().describe("Max results (default 6, max 12)."),
+            ...feedArg,
+        },
+    }, (args) => guard(async () => {
+        const data = await api.get("/stops/search", {
+            q: args.query,
+            limit: args.limit ?? 6,
+            feed_id: feed(args.feed_id),
+        });
+        if (!data.stops?.length) {
+            return text(`No stops matched "${args.query}". Try a shorter or different term, or use ` +
+                `find_nearby_stops with coordinates from geocode_address.`);
+        }
+        const lines = data.stops.map((s) => `• ${s.label || s.name} — stop_id: ${s.id}` +
+            `, location: ${fmtCoord(s.lat)}, ${fmtCoord(s.lon)}`);
+        return text(`Matching stops:\n${lines.join("\n")}`);
+    }));
+    /* 4. get_stop_departures */
+    server.registerTool("get_stop_departures", {
+        title: "Get stop departures",
+        description: "Get the next departures from a specific stop, merged across all routes that " +
+            "serve it. Use after finding a stop via find_nearby_stops or search_stops. " +
+            "Times are in the agency's local timezone; 'minutes' is minutes from now.",
+        inputSchema: {
+            stop_id: z.string().min(1).describe("GTFS stop_id (from a stop search/nearby result)."),
+            limit: z.number().int().positive().max(20).optional().describe("Max departures (default 8, max 20)."),
+            ...feedArg,
+        },
+    }, (args) => guard(async () => {
+        const data = await api.get("/stops/departures", {
+            stop_id: args.stop_id,
+            limit: args.limit ?? 8,
+            feed_id: feed(args.feed_id),
+        });
+        const stopName = data.stop?.name || `stop ${args.stop_id}`;
+        if (!data.departures?.length) {
+            return text(`No upcoming departures are scheduled from ${stopName} right now. There may ` +
+                `be no more service today — suggest checking the agency website for the full schedule.`);
+        }
+        const lines = data.departures.map((d) => `• ${d.time} (in ${d.minutes} min) — Route ${d.name}` +
+            `${d.headsign ? ` toward ${d.headsign}` : ""} (route_id: ${d.route_id})`);
+        return text(`Next departures from ${stopName}:\n${lines.join("\n")}`);
+    }));
+    /* 5. get_route_map */
+    server.registerTool("get_route_map", {
+        title: "Get route map data",
+        description: "Get geographic data for a single route: its shape (an ordered list of " +
+            "lat/lon points forming the path) and the stops it serves. Useful for " +
+            "describing where a route goes. The shape can be long; the summary reports " +
+            "its size and lists the stops.",
+        inputSchema: {
+            route_id: z.string().min(1).describe("GTFS route_id."),
+            ...feedArg,
+        },
+    }, (args) => guard(async () => {
+        const data = await api.get(`/map/route/${encodeURIComponent(args.route_id)}`, { feed_id: feed(args.feed_id) });
+        const stops = data.stops || [];
+        if (!stops.length && !(data.shapes || []).length) {
+            return text(`No map data was found for route_id "${args.route_id}".`);
+        }
+        const stopLines = stops.map((s) => `  - ${s.name} (stop_id: ${s.id}) at ${fmtCoord(s.lat)}, ${fmtCoord(s.lon)}`);
+        return text(`Route ${args.route_id} has ${stops.length} stops and a path of ` +
+            `${(data.shapes || []).length} shape points.\nStops:\n${stopLines.join("\n")}`);
+    }));
+    /* 6. get_system_map */
+    server.registerTool("get_system_map", {
+        title: "Get system map",
+        description: "Get every route in the transit system with its name, color, and the stops it " +
+            "serves. Use when the rider asks what routes exist or wants an overview of the " +
+            "network. Shape geometry is omitted from the summary to keep it readable.",
+        inputSchema: { ...feedArg },
+    }, (args) => guard(async () => {
+        const data = await api.get("/map/system", {
+            feed_id: feed(args.feed_id),
+        });
+        if (!data.routes?.length)
+            return text("No routes are configured for this feed.");
+        const lines = data.routes.map((r) => {
+            const label = r.long_name && r.long_name !== r.name ? `${r.name} — ${r.long_name}` : r.name;
+            return `• Route ${label} (route_id: ${r.route_id}) — ${r.stops?.length ?? 0} stops`;
+        });
+        return text(`The system has ${data.routes.length} routes:\n${lines.join("\n")}`);
+    }));
+    /* 7. get_service_alerts */
+    server.registerTool("get_service_alerts", {
+        title: "Get service alerts",
+        description: "Get active service alerts (delays, detours, cancellations) from GTFS-Realtime. " +
+            "IMPORTANT: an empty result is normal and means there are currently NO active " +
+            "alerts — it does NOT mean buses aren't running. Many agencies have no alerts " +
+            "most of the time, and some have no realtime feed at all.",
+        inputSchema: {
+            route_id: z.string().optional().describe("Optional: filter alerts to one route_id."),
+            ...feedArg,
+        },
+    }, (args) => guard(async () => {
+        const data = await api.get("/rt/alerts", {
+            feed_id: feed(args.feed_id),
+            route_id: args.route_id,
+        });
+        const alerts = data.alerts || [];
+        if (!alerts.length) {
+            return text("There are no active service alerts right now. Normal service is in effect " +
+                "(no delays, detours, or cancellations are being reported).");
+        }
+        const blocks = alerts.map((a) => {
+            const tags = [
+                a.severity != null ? SEVERITY[a.severity] : null,
+                a.effect != null ? EFFECT[a.effect] : null,
+                a.cause != null ? CAUSE[a.cause] : null,
+            ].filter(Boolean);
+            const head = `⚠ ${a.header || "Service alert"}${tags.length ? ` [${tags.join(" · ")}]` : ""}`;
+            const body = a.description ? `\n  ${a.description}` : "";
+            const routes = a.routes?.length ? `\n  Affected routes: ${a.routes.join(", ")}` : "";
+            const more = a.url ? `\n  More info: ${a.url}` : "";
+            return head + body + routes + more;
+        });
+        return text(`Active service alerts:\n${blocks.join("\n\n")}`);
+    }));
+    /* 8. get_live_vehicles */
+    server.registerTool("get_live_vehicles", {
+        title: "Get live vehicles",
+        description: "Get real-time vehicle positions from GTFS-Realtime: each bus's location, " +
+            "heading, the route it's on, and its next stop. IMPORTANT: an empty result is " +
+            "normal — it means no vehicles are currently reporting (off-hours, or the " +
+            "agency has no realtime vehicle feed). It does NOT imply the schedule is wrong.",
+        inputSchema: {
+            route_id: z.string().optional().describe("Optional: filter to vehicles on one route_id."),
+            ...feedArg,
+        },
+    }, (args) => guard(async () => {
+        const data = await api.get("/rt/vehicles", {
+            feed_id: feed(args.feed_id),
+            route_id: args.route_id,
+        });
+        const vehicles = data.vehicles || [];
+        if (!vehicles.length) {
+            return text("No vehicles are reporting their position right now. This is normal outside " +
+                "service hours or for agencies without a realtime vehicle feed; it doesn't " +
+                "mean scheduled service isn't running. Use get_stop_departures for the schedule.");
+        }
+        const lines = vehicles.map((v) => {
+            const where = v.next_stop
+                ? ` — next stop: ${v.next_stop}${v.next_eta != null ? ` (~${v.next_eta} min)` : ""}`
+                : "";
+            return (`• Route ${v.route_name || v.route_id} bus ${v.id} at ` +
+                `${fmtCoord(v.lat)}, ${fmtCoord(v.lon)}` +
+                `${v.bearing != null ? `, heading ${Math.round(v.bearing)}°` : ""}${where}`);
+        });
+        return text(`Live vehicles (${vehicles.length}):\n${lines.join("\n")}`);
+    }));
+    /* 9. geocode_address */
+    server.registerTool("geocode_address", {
+        title: "Geocode an address",
+        description: "Convert an address, landmark, or place name into coordinates, biased to the " +
+            "agency's service area. Use this to get a latitude/longitude you can then pass " +
+            "to find_nearby_stops.",
+        inputSchema: {
+            address: z.string().min(1).describe("Address, landmark, or place name."),
+            ...feedArg,
+        },
+    }, (args) => guard(async () => {
+        const data = await api.get("/geocode", {
+            q: args.address,
+            feed_id: feed(args.feed_id),
+        });
+        if (data == null || typeof data.lat !== "number" || typeof data.lon !== "number") {
+            return text(`Could not find coordinates for "${args.address}". Try a more specific or ` +
+                `nearby place name, or search by stop name with search_stops.`);
+        }
+        return text(`${data.label || args.address}\nCoordinates: ${fmtCoord(data.lat)}, ${fmtCoord(data.lon)}\n` +
+            `Pass these to find_nearby_stops to find the closest stops.`);
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Response shapes for the WP GTFS Pro REST API (`/wp-json/wp-gtfs-pro/v1/*`).
+ *
+ * These mirror the actual JSON returned by a live GTFS Pro site (verified against
+ * a production install), not the idealized shapes in the spec — where they differ,
+ * reality wins. Notably: `/stops/search` and `/stops/nearby` wrap results in a
+ * `stops` array, and RT vehicles use `id`/`next_eta`/`next_stop` (not the
+ * `vehicle_id`/`speed` the spec sketches).
+ */
+export interface Feed {
+    id: string;
+    name: string;
+    url: string;
+    active: boolean;
+    logo?: number;
+    rt_vehicles?: string;
+    rt_trips?: string;
+    rt_alerts?: string;
+}
+/** One route serving a stop, with its next scheduled departure times. */
+export interface RouteAtStop {
+    route_id: string;
+    name: string;
+    color: string;
+    url?: string;
+    next: string[];
+}
+export interface NearbyStop {
+    id: string;
+    name: string;
+    code: string;
+    lat: number;
+    lon: number;
+    distance_m: number;
+    distance_text: string;
+    is_timepoint: boolean;
+    routes: RouteAtStop[];
+}
+export interface NearbyStopsResponse {
+    stops: NearbyStop[];
+}
+export interface SearchStop {
+    id: string;
+    name: string;
+    code: string;
+    lat: number;
+    lon: number;
+    label: string;
+    type: string;
+}
+export interface SearchStopsResponse {
+    stops: SearchStop[];
+}
+export interface Departure {
+    route_id: string;
+    name: string;
+    color: string;
+    url?: string;
+    headsign: string;
+    time: string;
+    minutes: number;
+}
+export interface DeparturesResponse {
+    stop: {
+        id: string;
+        name: string;
+        code: string;
+    };
+    departures: Departure[];
+    ts: number;
+}
+export interface MapStop {
+    id: string;
+    name: string;
+    code: string;
+    lat: number;
+    lon: number;
+}
+/** A shape point is a [latitude, longitude] pair. */
+export type ShapePoint = [number, number];
+export interface RouteMapResponse {
+    shapes: ShapePoint[];
+    stops: MapStop[];
+}
+export interface SystemRoute {
+    route_id: string;
+    name: string;
+    long_name: string;
+    color: string;
+    shapes: ShapePoint[];
+    stops: MapStop[];
+}
+export interface SystemMapResponse {
+    routes: SystemRoute[];
+}
+export interface AlertActivePeriod {
+    start: number | null;
+    end: number | null;
+}
+export interface Alert {
+    id: string;
+    header: string;
+    description: string;
+    url: string;
+    /** GTFS-RT Cause enum (integer). Translate before showing to a human. */
+    cause: number | null;
+    /** GTFS-RT Effect enum (integer). */
+    effect: number | null;
+    /** GTFS-RT SeverityLevel enum (integer). */
+    severity: number | null;
+    routes: string[];
+    stops: string[];
+    active_period: AlertActivePeriod[];
+}
+export interface AlertsResponse {
+    alerts: Alert[];
+    ts?: number;
+}
+export interface Vehicle {
+    id: string;
+    lat: number;
+    lon: number;
+    bearing: number | null;
+    route_id: string;
+    trip_id: string;
+    direction_id: number | null;
+    stop_id: string | null;
+    status: number | null;
+    timestamp: number | null;
+    route_name: string;
+    color: string;
+    direction: string | null;
+    next_stop: string | null;
+    next_eta: number | null;
+}
+export interface VehiclesResponse {
+    vehicles: Vehicle[];
+    ts?: number;
+}
+export interface GeocodeResponse {
+    lat: number;
+    lon: number;
+    label: string;
+}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * Response shapes for the WP GTFS Pro REST API (`/wp-json/wp-gtfs-pro/v1/*`).
+ *
+ * These mirror the actual JSON returned by a live GTFS Pro site (verified against
+ * a production install), not the idealized shapes in the spec — where they differ,
+ * reality wins. Notably: `/stops/search` and `/stops/nearby` wrap results in a
+ * `stops` array, and RT vehicles use `id`/`next_eta`/`next_stop` (not the
+ * `vehicle_id`/`speed` the spec sketches).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/gtfs-pro.config.example.json

@@ -0,0 +1,7 @@
+{
+  "gtfs_pro_url": "https://your-agency-site.org",
+  "feed_id": "default",
+  "cache_ttl_seconds": 30,
+  "agency_name": "Your Transit Agency",
+  "agency_description": "Public transit serving your service area. Describe the cities, landmarks, and regions covered so the AI knows what this server is for."
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "gtfs-pro-mcp",
+  "version": "1.0.0",
+  "description": "Model Context Protocol server for any WP GTFS Pro transit site. Lets AI assistants query bus stops, schedules, routes, live vehicle positions, and service alerts from an agency's live GTFS data.",
+  "license": "GPL-2.0-or-later",
+  "author": "Digital Mountaineers",
+  "homepage": "https://github.com/digital-mountaineers/gtfs-pro-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/digital-mountaineers/gtfs-pro-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/digital-mountaineers/gtfs-pro-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "gtfs",
+    "gtfs-realtime",
+    "transit",
+    "public-transit",
+    "bus",
+    "wordpress",
+    "claude",
+    "ai"
+  ],
+  "type": "module",
+  "bin": {
+    "gtfs-pro-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "gtfs-pro.config.example.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  }
+}