Skip to main content
Glama

Citi Bike MCP Server

by sjhangiani12
README.md1.36 kB
**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).

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sjhangiani12/citibike_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server