# CityBikes MCP

> CityBikes provides instant access to real-time bike-sharing data from over 400 global cities. Use this MCP to list entire network topologies and fetch live counts for bikes and empty docks at specific stations worldwide.

## Overview
- **Category:** travel-hospitality
- **Price:** Free
- **Tags:** bike-sharing, micromobility, real-time-data, public-transport, smart-city

## Description

Need to plan a commute or just figure out how to get around a new city? This connector gives your AI client the real-time status of bike-sharing systems across hundreds of global networks. You don't have to download ten different city apps; you just ask your agent, and it pulls the live data. It tells you exactly which networks are running in an area and how many bikes or docks are available at any given station right now. Whether you’re writing a travel guide or building a local transit dashboard, this MCP makes sure you have precise micrmobility numbers when you need them. You can find the CityBikes integration within the Vinkius catalog alongside other global tools to build out your agent's capabilities.

## Tools

### get_network
Retrieves comprehensive details and metadata for one specific bike-sharing network.

### list_networks
Returns a list of all supported bike-sharing networks, helping you find the IDs needed for deeper queries.

## Prompt Examples

**Prompt:** 
```
List all bike-sharing networks available in Italy.
```

**Response:** 
```
I've found several networks in Italy. Some major ones include 'Bicincittà' in various cities, 'ToBike' in Turin (ID: tobike), and 'BikeMi' in Milan (ID: bikemi). Which city are you interested in?
```

**Prompt:** 
```
Check the current bike availability for the 'velib' network in Paris.
```

**Response:** 
```
Fetching live data for Vélib' Métropole... I see 1,400+ stations. For example, the station at 'Mairie du 14ème' currently has 12 mechanical bikes and 5 electric bikes available. Do you want to check a specific area?
```

**Prompt:** 
```
Get detailed information for the bike network with ID 'citibike-nyc'.
```

**Response:** 
```
Accessing Citi Bike NYC data... This network operates in New York, NY. I have access to real-time status for all stations, including location coordinates and current bike/dock counts. Would you like a summary of the nearest stations?
```

## Capabilities

### Discover Global Networks
List every supported bike-sharing network worldwide, providing names and unique identifiers for each system.

### Check Station Availability
Fetch live data for a specific network to get the exact count of bikes and empty docking spots at all stations.

### Map Network Locations
Retrieve precise geographic coordinates and names for bike-sharing stations in any supported city.

## Use Cases

### Planning a multi-city trip
A travel planner needs to know if bike sharing is viable in five different European cities. They run `list_networks` via their agent, which provides the IDs and confirms coverage for all five locations instantly.

### Building a logistics dashboard
An ops engineer must monitor fleet distribution across several urban zones. They use this MCP to check real-time availability, getting counts of bikes and empty docks at multiple stations in one query.

### Researching micro-mobility trends
A data analyst is studying the growth rate of bike sharing. They systematically use `list_networks` to pull IDs for dozens of global systems, gathering a massive dataset for visualization projects.

### Debugging travel tools
A developer needs to ensure their custom app can handle network changes. They run `get_network` on known high-traffic areas like Manhattan to validate the current station structure and coordinates.

## Benefits

- Stop guessing if a city has bike sharing. Use `list_networks` to see every supported system in one query, eliminating the need for manual searches or multiple apps.
- Instead of visiting station by station, you can ask your agent for real-time status on an entire network, knowing exactly how many bikes and docks are available right now.
- The ability to access metadata means you get precise coordinates for every station. This is critical if you're building a map-based travel tool.
- You don't have to write complex API calls yourself. Your agent handles the data retrieval, letting you focus only on the answer: 'How many bikes are here?'
- This MCP supports global coverage. Whether your project is in Europe or Asia, it draws from hundreds of different local bike-sharing systems.
- It saves time by grouping related actions. You can first run `list_networks` to find an ID, and then pass that ID to get the specific details you need.

## How It Works

The bottom line is that your AI client handles the connection and data formatting; you just ask for what you need.

1. Subscribe to this MCP on Vinkius.
2. Start querying your agent with a request (e.g., 'List all networks in Italy').
3. Your agent uses the tool definitions to pull the live data, giving you immediate status reports.

## Frequently Asked Questions

**How does list_networks work with multiple cities?**
The `list_networks` tool finds all supported networks globally. You can then filter this list by location or ID to narrow down exactly what you need, saving time.

**Do I need an API key for get_network?**
No complex keys are required for public access. Once connected through your agent on Vinkius, querying specific networks is straightforward.

**Can list_networks tell me if a network exists in my city?**
Yes, running `list_networks` pulls the global inventory. If it shows an ID or name related to your location, you know the network is supported and available for querying.

**Is get_network better than list_networks for checking status?**
No. Use `list_networks` first to find all potential services in an area; then, use `get_network` on the specific ID you want detailed real-time counts from.

**What kind of specific data fields does get_network provide for a bike-sharing system?**
It provides detailed metadata, including location coordinates, unique IDs, and operational status. You can use this information to map out the entire infrastructure or verify if a network is still active.

**What happens if I run list_networks but don't know which country to look in?**
The system will return all supported networks globally. This lets you discover potential bike-sharing systems across dozens of cities without needing to know the exact location beforehand.

**If I use get_network and it returns an error, what should I check first?**
First, verify the network ID or name for typos. If the input is correct but fails, try running list_networks to confirm the system's current supported IDs.

**Do I need to write code in my AI client to use get_network?**
No, you don't write code. You simply ask your AI agent to execute the function, and it handles all the underlying API calls for you automatically.

**How can I find the specific ID for a bike network in my city?**
Use the `list_networks` tool. You can ask the agent to filter the results by city or country name to find the correct `id` (e.g., 'velib' for Paris or 'citibike-nyc' for New York).

**Does the server show the exact number of available bikes at a station?**
Yes! By using the `get_network` tool with a specific `network_id`, the agent retrieves real-time station data, including the count of free bikes and empty docks.

**Is the data updated in real-time?**
The data is fetched directly from the CityBikes API, which aggregates live feeds from various operators. The refresh rate depends on the individual bike-sharing provider's own API updates.