onebusaway-mcp-server 0.1.1

package/README.md

@@ -0,0 +1,322 @@
+<div align="center">
+  <h1>onebusaway-mcp-server</h1>
+  <p><b>Query stops, routes, real-time arrivals, vehicle positions, and schedules from OneBusAway transit APIs via MCP. STDIO or Streamable HTTP.</b>
+  <div>13 Tools • 2 Resources</div>
+  </p>
+</div>
+
+<div align="center">
+
+[![Version](https://img.shields.io/badge/Version-0.1.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/onebusaway-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/onebusaway-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/onebusaway-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun->=1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
+
+</div>
+
+<div align="center">
+
+[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/onebusaway-mcp-server/releases/latest/download/onebusaway-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=onebusaway-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm9uZWJ1c2F3YXktbWNwLXNlcnZlciJdLCJlbnYiOnsiT05FQlVTQVdBWV9BUElfS0VZIjoiVEVTVCJ9fQ==) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22onebusaway-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22onebusaway-mcp-server%22%5D%2C%22env%22%3A%7B%22ONEBUSAWAY_API_KEY%22%3A%22TEST%22%7D%7D)
+
+[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
+
+</div>
+
+---
+
+## Tools
+
+13 tools covering the full OneBusAway transit data surface — discovery, real-time operations, and schedules:
+
+| Tool | Description |
+|:---|:---|
+| `onebusaway_list_agencies` | List all transit agencies on this OneBusAway instance with IDs, contact info, and geographic coverage |
+| `onebusaway_find_stops` | Find bus stops near a lat/lon within a configurable radius, optionally filtered by stop code |
+| `onebusaway_search_stops` | Search stops by name or code string to resolve a human-readable name to a stop ID |
+| `onebusaway_get_stop` | Fetch details for a specific stop by agency-prefixed ID |
+| `onebusaway_find_routes` | Find transit routes near a lat/lon, optionally filtered by name or number |
+| `onebusaway_search_routes` | Search routes by name or number to resolve a route short name to a route ID |
+| `onebusaway_get_route` | Fetch details for a specific route by agency-prefixed ID |
+| `onebusaway_list_routes_for_agency` | List all routes operated by an agency |
+| `onebusaway_get_arrivals` | Real-time arrivals and departures at a stop — GPS-tracked predictions, schedule deviation, vehicle positions, and active alerts |
+| `onebusaway_get_trip` | Real-time status and full stop sequence for an active trip |
+| `onebusaway_get_vehicles` | Real-time positions of all active vehicles for an agency, optionally filtered to one route |
+| `onebusaway_get_schedule_for_stop` | Full-day departure schedule for a stop by route and direction |
+| `onebusaway_get_schedule_for_route` | Full-day schedule for a route — all trips and stop sequences |
+
+### `onebusaway_find_stops`
+
+Find bus stops near a geographic location.
+
+- Configurable search radius (default 300m, max ~1600m before results degrade)
+- Optional stop code filter (the number printed on the sign, e.g. `75403`)
+- Returns stop ID, code, name, direction, served route IDs, and wheelchair boarding status
+- `limitExceeded` flag signals when more stops exist beyond the returned set
+- Stop IDs returned here feed directly into `onebusaway_get_arrivals`
+
+---
+
+### `onebusaway_get_arrivals`
+
+Real-time arrivals and departures at a stop.
+
+- Configurable time window (`minutesBefore`, `minutesAfter` — defaults 5/35)
+- `predicted` boolean distinguishes GPS-tracked estimates from schedule-only projections
+- Schedule deviation in seconds (positive = late, negative = early)
+- Vehicle position and stops-away count when available
+- Active service alert summaries included inline
+- `tripId` on each arrival feeds `onebusaway_get_trip` for vehicle tracking
+
+---
+
+### `onebusaway_get_trip`
+
+Real-time status and stop sequence for a specific trip.
+
+- Journey phase (`in_progress`, `layover_before`, `layover_during`)
+- Vehicle GPS position, heading, and schedule deviation
+- Full stop sequence with GTFS arrival/departure times and distance along trip
+- Optional `serviceDateMs` for looking up trips from a prior service day
+
+---
+
+### `onebusaway_get_vehicles`
+
+Real-time positions of all active vehicles for an agency.
+
+- Returns GPS coordinates, heading, schedule deviation, and current trip for every active vehicle
+- Optional `routeId` filter (applied client-side after fetching all agency vehicles)
+- Phase and `predicted` flag distinguish actively-reporting vehicles from stale entries
+
+---
+
+### `onebusaway_search_routes`
+
+Search for routes by name or number across the instance.
+
+- Falls back gracefully: the Puget Sound instance returns 404 on the search endpoint — `onebusaway_find_routes` (lat/lon) or `onebusaway_list_routes_for_agency` are the alternatives
+- Error contract surfaces this with structured recovery hints
+
+---
+
+### `onebusaway_get_schedule_for_stop` and `onebusaway_get_schedule_for_route`
+
+Static schedule lookups — full-day timetables without real-time data.
+
+- Date parameter (ISO 8601) defaults to today in the agency's timezone
+- `onebusaway_get_schedule_for_stop`: all departures grouped by route and direction, with trip IDs for follow-up calls
+- `onebusaway_get_schedule_for_route`: all trips for the route with full stop sequences and GTFS stop times
+
+## Resources
+
+| Type | Name | Description |
+|:---|:---|:---|
+| Resource | `onebusaway://stop/{stopId}` | Stop metadata — name, coordinates, served routes, and wheelchair accessibility |
+| Resource | `onebusaway://route/{routeId}` | Route metadata — short name, description, agency, and schedule URL |
+
+All resource data is also reachable via `onebusaway_get_stop` and `onebusaway_get_route`. Stop and route IDs use agency-prefixed format: `{agencyId}_{localId}` (e.g. `1_75403`, `1_100259`).
+
+## Features
+
+Built on [`@cyanheads/mcp-ts-core`](https://www.npmjs.com/package/@cyanheads/mcp-ts-core):
+
+- Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
+- Unified error handling — handlers throw, framework catches, classifies, and formats
+- Pluggable auth: `none`, `jwt`, `oauth`
+- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`
+- Structured logging with optional OpenTelemetry tracing
+- STDIO and Streamable HTTP transports
+
+OneBusAway-specific:
+
+- Wraps [`onebusaway-sdk`](https://www.npmjs.com/package/onebusaway-sdk) with typed error classification (`NotFound`, `RateLimited`, `ServiceUnavailable`)
+- Defaults to the Puget Sound instance (`api.pugetsound.onebusaway.org`) — works with `ONEBUSAWAY_API_KEY=TEST` for development
+- Configurable `ONEBUSAWAY_BASE_URL` for any OneBusAway-compatible instance (NYC, Washington DC, Tampa, etc.)
+- Server-level instructions guide agents through stop ID format, recommended workflows, and OneBusAway's limitations (no trip planning)
+
+Agent-friendly output:
+
+- `predicted` boolean on every arrival and vehicle distinguishes GPS-tracked data from schedule-only projections — agents branch on data, not string parsing
+- Schedule deviation in seconds on arrivals, trips, and vehicle positions — structured for countdown timer math
+- Cross-tool linkage: `tripId` from arrivals feeds `onebusaway_get_trip`; `stopId` from searches feeds arrivals; `agencyId` from list feeds vehicles and route listing
+- Structured error contracts with recovery hints (`onebusaway_search_routes` 404 → fallback to `onebusaway_find_routes` or `onebusaway_list_routes_for_agency`)
+
+## Getting started
+
+Add the following to your MCP client configuration file. `ONEBUSAWAY_API_KEY=TEST` works on the Puget Sound instance without registration.
+
+```json
+{
+  "mcpServers": {
+    "onebusaway": {
+      "type": "stdio",
+      "command": "bunx",
+      "args": ["onebusaway-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info",
+        "ONEBUSAWAY_API_KEY": "TEST"
+      }
+    }
+  }
+}
+```
+
+Or with npx (no Bun required):
+
+```json
+{
+  "mcpServers": {
+    "onebusaway": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "onebusaway-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info",
+        "ONEBUSAWAY_API_KEY": "TEST"
+      }
+    }
+  }
+}
+```
+
+Or with Docker:
+
+```json
+{
+  "mcpServers": {
+    "onebusaway": {
+      "type": "stdio",
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "-e", "MCP_TRANSPORT_TYPE=stdio",
+        "-e", "ONEBUSAWAY_API_KEY=TEST",
+        "ghcr.io/cyanheads/onebusaway-mcp-server:latest"
+      ]
+    }
+  }
+}
+```
+
+For Streamable HTTP, set the transport and start the server:
+
+```sh
+MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 ONEBUSAWAY_API_KEY=TEST bun run start:http
+# Server listens at http://localhost:3010/mcp
+```
+
+### Prerequisites
+
+- [Bun v1.3.0](https://bun.sh/) or higher (or Node.js v24+).
+- An OneBusAway API key. `TEST` works on the Puget Sound instance for development. For production use or other instances, register at the relevant agency's developer portal.
+
+### Installation
+
+1. **Clone the repository:**
+
+```sh
+git clone https://github.com/cyanheads/onebusaway-mcp-server.git
+```
+
+2. **Navigate into the directory:**
+
+```sh
+cd onebusaway-mcp-server
+```
+
+3. **Install dependencies:**
+
+```sh
+bun install
+```
+
+4. **Configure environment:**
+
+```sh
+cp .env.example .env
+# edit .env — set ONEBUSAWAY_API_KEY if needed
+```
+
+## Configuration
+
+All configuration is validated at startup via Zod schemas. Key environment variables:
+
+| Variable | Description | Default |
+|:---|:---|:---|
+| `ONEBUSAWAY_API_KEY` | OneBusAway API key. `TEST` works on Puget Sound for development. | `TEST` |
+| `ONEBUSAWAY_BASE_URL` | Base URL for the OneBusAway instance. | `https://api.pugetsound.onebusaway.org` |
+| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |
+| `MCP_HTTP_PORT` | HTTP server port. | `3010` |
+| `MCP_HTTP_ENDPOINT_PATH` | HTTP endpoint path. | `/mcp` |
+| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |
+| `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `notice`, `warning`, `error`). | `info` |
+| `LOGS_DIR` | Directory for log files (Node.js only). | `<project-root>/logs` |
+| `STORAGE_PROVIDER_TYPE` | Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1`. | `in-memory` |
+| `OTEL_ENABLED` | Enable OpenTelemetry instrumentation. | `false` |
+
+See [`.env.example`](./.env.example) for the full list of optional overrides.
+
+## Running the server
+
+### Local development
+
+- **Build and run the production version:**
+
+  ```sh
+  # One-time build
+  bun run rebuild
+
+  # Run the built server
+  bun run start:http
+  # or
+  bun run start:stdio
+  ```
+
+- **Run checks and tests:**
+
+  ```sh
+  bun run devcheck   # Lint, format, typecheck, security, changelog sync
+  bun run test       # Vitest test suite
+  bun run lint:mcp   # Validate MCP definitions against spec
+  ```
+
+### Docker
+
+```sh
+docker build -t onebusaway-mcp-server .
+docker run --rm -e ONEBUSAWAY_API_KEY=TEST -p 3010:3010 onebusaway-mcp-server
+```
+
+The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/onebusaway-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.
+
+## Project structure
+
+| Directory | Purpose |
+|:---|:---|
+| `src/index.ts` | `createApp()` entry point — registers tools/resources and inits the OneBusAway service. |
+| `src/config/server-config.ts` | Server-specific env var parsing: `ONEBUSAWAY_API_KEY`, `ONEBUSAWAY_BASE_URL`. |
+| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). 13 tools across discovery, real-time, and schedule operations. |
+| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). Stop and route metadata resources. |
+| `src/services/onebusaway` | OneBusAway service — wraps `onebusaway-sdk`, typed error classification, domain types. |
+| `tests/` | Unit and integration tests mirroring `src/`. 77 tests covering all tools and resources. |
+
+## Development guide
+
+See [`CLAUDE.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:
+
+- Handlers throw, framework catches — no `try/catch` in tool logic
+- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage
+- Register new tools and resources in the `createApp()` arrays in `src/index.ts`
+- Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields
+
+## Contributing
+
+Issues and pull requests are welcome. Run checks and tests before submitting:
+
+```sh
+bun run devcheck
+bun run test
+```
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE) for details.

package/changelog/0.1.x/0.1.0.md

@@ -0,0 +1,15 @@
+---
+summary: "Initial release — 13 tools and 2 resources for OneBusAway transit data via onebusaway-sdk"
+breaking: false
+security: false
+---
+
+# 0.1.0 — 2026-05-23
+
+## Added
+
+- **13 tools**: `onebusaway_list_agencies`, `onebusaway_find_stops`, `onebusaway_get_stop`, `onebusaway_search_stops`, `onebusaway_find_routes`, `onebusaway_get_route`, `onebusaway_list_routes_for_agency`, `onebusaway_search_routes`, `onebusaway_get_arrivals`, `onebusaway_get_trip`, `onebusaway_get_vehicles`, `onebusaway_get_schedule_for_stop`, `onebusaway_get_schedule_for_route`.
+- **2 resources**: `onebusaway://stop/{stopId}`, `onebusaway://route/{routeId}`.
+- **`OneBusAwayService`** wrapping `onebusaway-sdk` with typed error classification (`NotFound`, `RateLimited`, `ServiceUnavailable`).
+- **`ONEBUSAWAY_API_KEY`** and **`ONEBUSAWAY_BASE_URL`** env vars; defaults to Puget Sound instance with `TEST` key.
+- 77 unit tests covering all tools and resources (happy path, error paths, format output, sparse payloads).

package/changelog/0.1.x/0.1.1.md

@@ -0,0 +1,17 @@
+---
+summary: "OneBusAway transit API — 13 tools, 2 resources, real-time arrivals, routes, stops, and vehicles"
+breaking: false
+security: false
+---
+
+# 0.1.1 — 2026-05-23
+
+## Added
+
+- **13 tools**: `onebusaway_list_agencies`, `onebusaway_find_stops`, `onebusaway_search_stops`, `onebusaway_get_stop`, `onebusaway_find_routes`, `onebusaway_search_routes`, `onebusaway_get_route`, `onebusaway_list_routes_for_agency`, `onebusaway_get_arrivals`, `onebusaway_get_trip`, `onebusaway_get_vehicles`, `onebusaway_get_schedule_for_stop`, `onebusaway_get_schedule_for_route`.
+- **2 resources**: `onebusaway://stop/{stopId}`, `onebusaway://route/{routeId}`.
+- **`OneBusAwayService`** wrapping `onebusaway-sdk` with typed error classification (`NotFound`, `RateLimited`, `ServiceUnavailable`).
+- **`ONEBUSAWAY_API_KEY`** and **`ONEBUSAWAY_BASE_URL`** env vars; defaults to Puget Sound instance with `TEST` key.
+- 77 unit tests covering all tools and resources (happy path, error paths, format output, sparse payloads).
+- README with install badges (Claude Desktop, Cursor, VS Code), tool table, and getting-started config snippets.
+- Docker image published to `ghcr.io/cyanheads/onebusaway-mcp-server`.

package/changelog/template.md

@@ -0,0 +1,119 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Server-specific configuration for onebusaway-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    apiKey: z.ZodDefault<z.ZodString>;
+    baseUrl: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAK3C,QAAA,MAAM,kBAAkB;;;iBAStB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}

package/dist/config/server-config.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Server-specific configuration for onebusaway-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const PUGET_SOUND_BASE_URL = 'https://api.pugetsound.onebusaway.org';
+const ServerConfigSchema = z.object({
+    apiKey: z
+        .string()
+        .default('TEST')
+        .describe('OneBusAway API key. TEST works on Puget Sound for development.'),
+    baseUrl: z
+        .string()
+        .default(PUGET_SOUND_BASE_URL)
+        .describe('Base URL for the OneBusAway instance.'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        apiKey: 'ONEBUSAWAY_API_KEY',
+        baseUrl: 'ONEBUSAWAY_BASE_URL',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,oBAAoB,GAAG,uCAAuC,CAAC;AAErE,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,OAAO,CAAC,oBAAoB,CAAC;SAC7B,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,MAAM,EAAE,oBAAoB;QAC5B,OAAO,EAAE,qBAAqB;KAC/B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview onebusaway-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview onebusaway-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+// Resources
+import { routeResource } from './mcp-server/resources/definitions/route.resource.js';
+import { stopResource } from './mcp-server/resources/definitions/stop.resource.js';
+// Tools
+import { findRoutes } from './mcp-server/tools/definitions/find-routes.tool.js';
+import { findStops } from './mcp-server/tools/definitions/find-stops.tool.js';
+import { getArrivals } from './mcp-server/tools/definitions/get-arrivals.tool.js';
+import { getRoute } from './mcp-server/tools/definitions/get-route.tool.js';
+import { getScheduleForRoute } from './mcp-server/tools/definitions/get-schedule-for-route.tool.js';
+import { getScheduleForStop } from './mcp-server/tools/definitions/get-schedule-for-stop.tool.js';
+import { getStop } from './mcp-server/tools/definitions/get-stop.tool.js';
+import { getTrip } from './mcp-server/tools/definitions/get-trip.tool.js';
+import { getVehicles } from './mcp-server/tools/definitions/get-vehicles.tool.js';
+import { listAgencies } from './mcp-server/tools/definitions/list-agencies.tool.js';
+import { listRoutesForAgency } from './mcp-server/tools/definitions/list-routes-for-agency.tool.js';
+import { searchRoutes } from './mcp-server/tools/definitions/search-routes.tool.js';
+import { searchStops } from './mcp-server/tools/definitions/search-stops.tool.js';
+import { initOneBusAwayService } from './services/onebusaway/onebusaway-service.js';
+await createApp({
+    tools: [
+        listAgencies,
+        findStops,
+        findRoutes,
+        searchStops,
+        searchRoutes,
+        getStop,
+        getRoute,
+        listRoutesForAgency,
+        getArrivals,
+        getTrip,
+        getVehicles,
+        getScheduleForStop,
+        getScheduleForRoute,
+    ],
+    resources: [stopResource, routeResource],
+    prompts: [],
+    instructions: 'OneBusAway MCP server — real-time transit data for Puget Sound (King County Metro, Sound Transit, Pierce Transit, Community Transit, and more) and other OneBusAway instances.\n' +
+        '- Stop IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_75403" for Metro Transit stop 75403)\n' +
+        '- To get arrivals: use onebusaway_find_stops or onebusaway_search_stops to resolve a location/name to a stopId, then call onebusaway_get_arrivals\n' +
+        '- For "where is the 44?": use onebusaway_search_routes to get routeId, then onebusaway_get_vehicles\n' +
+        '- OneBusAway does not include trip planning — direct users to Google Maps or Transit app for routing',
+    setup() {
+        initOneBusAwayService(getServerConfig());
+    },
+});
+//# 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;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,qDAAqD,CAAC;AACnF,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,mDAAmD,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,kDAAkD,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,MAAM,iDAAiD,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,iDAAiD,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAEpF,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,YAAY;QACZ,SAAS;QACT,UAAU;QACV,WAAW;QACX,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,mBAAmB;QACnB,WAAW;QACX,OAAO;QACP,WAAW;QACX,kBAAkB;QAClB,mBAAmB;KACpB;IACD,SAAS,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;IACxC,OAAO,EAAE,EAAE;IACX,YAAY,EACV,kLAAkL;QAClL,6GAA6G;QAC7G,qJAAqJ;QACrJ,uGAAuG;QACvG,sGAAsG;IACxG,KAAK;QACH,qBAAqB,CAAC,eAAe,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/route.resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview OneBusAway route metadata resource.
+ * @module mcp-server/resources/definitions/route.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const routeResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    routeId: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=route.resource.d.ts.map

package/dist/mcp-server/resources/definitions/route.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/route.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,aAAa;;wCA4BxB,CAAC"}

package/dist/mcp-server/resources/definitions/route.resource.js

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview OneBusAway route metadata resource.
+ * @module mcp-server/resources/definitions/route.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const routeResource = resource('onebusaway://route/{routeId}', {
+    name: 'onebusaway-route',
+    title: 'OneBusAway Route',
+    description: 'Route metadata — short name, description, agency, schedule URL. Route IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_100259").',
+    mimeType: 'application/json',
+    params: z.object({
+        routeId: z
+            .string()
+            .describe('Agency-prefixed route ID (e.g. "1_100259" for Metro Transit route 100259).'),
+    }),
+    async handler(params, ctx) {
+        ctx.log.debug('routeResource handler', { routeId: params.routeId });
+        const route = await getOneBusAwayService().getRoute(params.routeId, ctx);
+        return route;
+    },
+    list: async () => ({
+        resources: [
+            {
+                uri: 'onebusaway://route/1_100259',
+                name: 'Example: Metro Transit Route 100259',
+                mimeType: 'application/json',
+                description: 'Route metadata for Metro Transit route 100259 (Puget Sound instance).',
+            },
+        ],
+    }),
+});
+//# sourceMappingURL=route.resource.js.map

package/dist/mcp-server/resources/definitions/route.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/route.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAEnF,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC,8BAA8B,EAAE;IACpE,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EACT,+IAA+I;IACjJ,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CAAC,4EAA4E,CAAC;KAC1F,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,oBAAoB,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,6BAA6B;gBAClC,IAAI,EAAE,qCAAqC;gBAC3C,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,uEAAuE;aACrF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/stop.resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview OneBusAway stop metadata resource.
+ * @module mcp-server/resources/definitions/stop.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const stopResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    stopId: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=stop.resource.d.ts.map

package/dist/mcp-server/resources/definitions/stop.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/stop.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,YAAY;;wCA4BvB,CAAC"}