**Overview**
- Purpose: Smithery-compatible TypeScript MCP server exposing a tool to find the nearest Citi Bike stations by distance and ebike/classic availability.
- Data: Citi Bike GBFS feeds: `station_status.json` and `station_information.json`.

**Quickstart (Smithery)**
- Prereq: Node.js 18+ and a Smithery account/API key.
- Dev (requires Smithery CLI): `npm run dev` (port-forwards to Smithery Playground)
- Deploy: Push to GitHub, then use https://smithery.ai/new to deploy the repo.

**Local Build**
- Install deps: `npm install`
- Build: `npm run build`

**Entry Point**
- Smithery loads `src/index.ts` which exports a default `createServer` function returning an MCP server instance.

**Tool**
- `nearest_citibikes`: Returns nearest stations with distances and availability.
  - Input: `{ lat: number, lon: number, limit?: number }`
  - Output: JSON with `stations[]` including:
    - `name`, `station_id`, `lat`, `lon`, `distance_m`
    - `available_ebikes`, `available_classic_bikes`, `available_total_bikes`
    - `available_docks`, `capacity_total_docks`, `is_renting`, `is_returning`, `last_reported`

**Notes**
- `available_classic_bikes` uses `num_bikes_available_types.mechanical` when present; else derives as `num_bikes_available - num_ebikes_available`.
- Results are Haversine-sorted by distance. `limit` defaults to 5 (1–50 allowed).