📦

Citi Bike Nearby

Find nearby Citi Bike stations with distance and e-bike/classic availability. Choose optimal pickup or drop-off spots in seconds. Plan rides more efficiently across the Citi Bike network.

0 installs

Trust: 34 — Low

Science

Ask AI about Citi Bike Nearby

I know everything about Citi Bike Nearby. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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).