# NYC Taxi & Rideshare Trips AI Agent Connect

> NYC Taxi & Rideshare Trips MCP provides direct access to official Taxi and Limousine Commission records. Your AI client can pull specific trip details for yellow and green cabs, analyze FHV dispatch logs, and query monthly pickup counts across all 263 official taxi zones. It's built for analyzing demand and validating market trends using real NYC Open Data.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_ty984nOU0g4ordPCKU6KwmycLRtg7yo12MhHK808/ai-agent-connect
- **Tags:** new-york, nyc, taxi, rideshare, tlc, fvh, transit

## Description

You can pull official NYC TLC trip records to run demand analysis or market research without hunting through government portals. This MCP gives your AI agent the ability to look up specific trip details for yellow and green taxis, including fares, tips, and distances. If you're looking at the ride-hail market, you can query FHV dispatch logs to see pickup and dropoff patterns for Uber and Lyft class vehicles. 

Because the data is organized by fiscal year, you just tell your agent which year you're interested in, and it handles the rest. You can also map out activity by querying the 263 official taxi zones or checking monthly pickup counts per industry. It's a fast way to get hard numbers on how people are moving through the city, whether you're looking at individual trip costs or broad monthly trends in specific boroughs.

## Tools

### count_taxi_trips
This tool counts trips within a specific TLC dataset. Use it to get a sense of the total volume before you pull individual rows.

### get_taxi_zone
This tool resolves a 3 or 4 digit TLC zone ID into a human-readable name and borough.

### list_taxi_zones
This tool provides a full list of all TLC taxi zone IDs, names, and their corresponding boroughs.

### search_fhv_trips
This tool searches through For-Hire Vehicle trip records like Uber or Lyft. You can filter by year and use zone IDs to find specific ride-hail patterns.

### search_taxi_trips
This tool retrieves detailed records for yellow and green taxi trips. It provides access to fare amounts, tips, tolls, and trip distances for a given fiscal year.

### search_zone_pickups
This tool pulls monthly pickup and dropoff counts for yellow taxis, green cabs, and high-volume FHV. It is the best way to compare volume across different industries and zones.

## Prompt Examples

**Prompt:** 
```
Which taxi zone had the most pickups last month?
```

**Response:** 
```
The search_zone_pickups tool can identify the busiest zones by checking the trip counts for the specified month.
```

**Prompt:** 
```
How much does a Manhattan yellow taxi ride cost on average?
```

**Response:** 
```
You can use search_taxi_trips for 2024 yellow taxi data to get specific fare, tip, and toll amounts for Manhattan zones.
```

**Prompt:** 
```
Where do ride-hail pickups cluster around JFK?
```

**Response:** 
```
First, use list_taxi_zones to find the JFK zone ID, then use search_zone_pickups to see the FHV volume in that area.
```

## Capabilities

### Trip Detail Retrieval
Your agent pulls specific fare, tip, and distance data for individual taxi trips.

### Zone Mapping
The AI converts numeric zone IDs into specific names and boroughs.

### Market Volume Analysis
Your agent compares monthly pickup counts between yellow cabs, green cabs, and ride-hail services.

### FHV Pattern Tracking
The AI analyzes dispatch logs for high-volume ride-hail vehicles.

### Data Sizing
The AI counts total trips in a dataset to prepare for larger queries.

## Use Cases

### Demand Validation
Check if a specific neighborhood actually has high ride-hail demand by querying monthly pickup counts.

### Cost Modeling
Analyze yellow taxi fare and tip distributions to build accurate travel cost estimates.

### Competitive Analysis
Compare the volume of green cabs versus FHV services in specific boroughs.

### Geospatial Research
Map out how trip pickups and dropoffs shift between different taxi zones over time.

## Benefits

- Access official TLC data without needing to manage API keys.
- Get granular trip details like tolls and tips for specific years.
- Compare different transport industries across the same geographic zones.
- Directly query NYC Open Data through your existing AI interface.

## How It Works

Connect your AI client to Vinkius to start querying NYC trip data immediately.

1. Connect your AI client to the NYC Taxi & Rideshare Trips MCP via Vinkius.
2. Ask your agent to find a specific zone or trip year.
3. The agent uses the tools to pull data from the TLC datasets.
4. Your agent processes the raw trip or count data to answer your question.

## Frequently Asked Questions

**Do I need an API key to use this data?**
No. Vinkius hosts the MCP, so you can use the tools without managing your own API credentials.

**What years of taxi data are available?**
Yellow taxi data is available for 2023 and 2024, while green cab and FHV data covers 2024 and 2025. You can ask your agent to check which years are currently accessible.

**Can I see Uber and Lyft data?**
Yes. The FHV dispatch logs include data for the high-volume ride-hail class, which covers services like Uber and Lyft.

**How do I find the ID for a specific NYC neighborhood?**
You can use the list_taxi_zones tool to see all available names and IDs, or use get_taxi_zone if you already have a 3 or 4 digit ID.

**What kind of trip details can I get?**
For taxi trips, you can get the fare amount, tips, tolls, congestion surcharges, and total trip distance.

**Do I need an API key?**
No. NYC Open Data serves all public datasets anonymously over its SODA API (data.cityofnewyork.us). This MCP defines no credentials and needs nothing configured.

**Why do trip tools ask for a year?**
TLC publishes trip history year by year (yellow 2023–2024, green 2024, FHV 2024–2025). Each dataset is a separate view, so every trip tool takes a year parameter and tells you the available years when the one you pass is missing.

**What does the zone data cover?**
The zone table maps the city's 263 taxi zones to boroughs with stable location ids, and the monthly series gives pick-up and drop-off counts per zone and industry. Use them to rank busy taxi areas instead of fetching per-trip rows.