# BlaBlaCar MCP MCP

> BlaBlaCar connects your AI agent to the world's largest carpooling network. Find and compare shared rides between cities, check driver credibility, or map out multi-day international routes—all from a single command.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** carpooling, ride-sharing, transportation, booking, price-comparison, travel-logistics

## Description

Planning travel used to mean opening ten browser tabs: one for bus tickets, one for train schedules, and five others just to verify if the ride was worth it. Now your agent handles all of that. You tell it where you need to go, and it instantly pulls in every available carpool option, letting you compare prices and schedules across different drivers and times. Need to cross a border? It finds those international routes for you. If dates are flexible, don't sweat it; the system can scan multiple days to show you the cheapest options. You get these specialized tools through Vinkius, connecting them directly to your preferred AI client so you never have to manually check different booking sites again.

## Tools

### get_driver_profile
Retrieves a driver's ratings and review history to verify their background before you book a trip.

### get_trip_details
Provides complete information on a specific ride, including the vehicle type and exact pickup location.

### search_bus_trips
Searches for fixed-route bus services when carpooling isn't available for long distances.

### search_flexible_dates
Compares prices and availability across a range of days, useful when your travel dates aren't locked down yet.

### search_international_trips
Finds carpool rides that cross national borders by specifying country codes for origin and destination.

### search_trips_by_city
Performs general searches by name, returning trips between two cities without needing specific coordinates.

### search_trips
Runs a highly precise search using exact GPS coordinates for both the start and end points.

### search_trips_with_radius
Finds options within a flexible search area around specified coordinates, useful if your pickup spot might change slightly.

## Prompt Examples

**Prompt:** 
```
Find carpool rides from Paris to Lyon next Friday for 2 people
```

**Response:** 
```
I'll search all available carpool rides between Paris and Lyon for your date and show you the best options.
```

**Prompt:** 
```
What's the cheapest day to travel from São Paulo to Rio next week?
```

**Response:** 
```
I'll search with flexible dates to compare prices across the entire week.
```

**Prompt:** 
```
Show me both carpool and bus options from Madrid to Barcelona this weekend
```

**Response:** 
```
I'll search both carpool rides and BlaBlaCar Bus trips so you can compare all transportation options.
```

## Capabilities

### Find rides between two cities
Search for shared carpool trips using the departure and arrival city names.

### Map precise coordinates
Execute searches by providing specific GPS latitude and longitude points for both pickup and dropoff.

### Check driver trustworthiness
Retrieve a specific driver's profile, ratings, and passenger reviews before you book the trip.

### Compare bus routes
Search for professional, fixed-route bus services on longer distances where carpooling isn't available.

### Find cheapest travel dates
Scan a range of days around your target date to compare prices and availability across several weeks at once.

## Use Cases

### Planning a multi-country backpacking trip
A user needs to travel from France to Spain and then on to Italy. They ask their agent for 'carpool options across these three countries next month.' The agent uses `search_international_trips` first, finds the best initial legs, and then suggests connecting bus routes using `search_bus_trips`.

### Finding the cheapest weekend getaway
A group needs to go from Denver to Salt Lake City but doesn't care about the exact date. They prompt their agent: 'What’s the best time to travel next month?' The agent executes `search_flexible_dates` and shows the lowest average price for that whole period.

### Figuring out a complex connection
A user needs a ride from a specific industrial park (coordinates known) to the nearest major bus hub. They use `search_trips` with GPS coordinates, then follow up by running `get_trip_details` on the best option to check the exact pickup location.

### Comparing options for a fixed route
A user needs to get from Paris to Lyon this coming Saturday. They ask their agent, who executes `search_trips_by_city` and compares the carpool price against available bus tickets using `search_bus_trips`.

## Benefits

- You can verify driver credibility using `get_driver_profile` before you commit to a journey, which is much safer than relying only on public reviews.
- Don't waste time checking multiple sites. Use `search_trips_by_city` for simple city-to-city searches; it provides all the necessary data in one place.
- Need to cross borders? The `search_international_trips` tool handles the complexity of country codes, so you don't have to worry about national limitations.
- If your schedule is loose, use `search_flexible_dates`. This lets you compare prices across weeks instead of just one specific day.
- When you know the exact coordinates but need options around them, `search_trips_with_radius` gives a much wider net than a fixed point search.

## How It Works

The bottom line is that you get instant comparisons from every possible type of shared transportation on one screen.

1. You tell your AI agent the route, approximate location, and required dates in natural language.
2. The agent uses multiple tools—like `search_trips_by_city` or `search_flexible_dates`—to gather all relevant options (carpool, bus, international) and compare them instantly.
3. Your agent presents a summary of the best routes, including prices, schedules, driver ratings, and available seats.

## Frequently Asked Questions

**How do I find rides if my pickup point isn't exactly on a road?**
Use `search_trips_with_radius`. This function searches for all available options within a specified zone around your coordinates, giving you more flexibility than searching a fixed point.

**Can I search for trips between two countries using the BlaBlaCar MCP?**
Yes. You must use `search_international_trips`, which requires country codes (like FR and DE) to find available cross-border rides.

**Which tool is best for a simple city-to-city search?**
Start with `search_trips_by_city`. It's the most user-friendly option because you only need to provide two names, not precise coordinates.

**If I don't know my exact travel dates, what should I use?**
Use `search_flexible_dates`. This tool scans a range of time around your target date and reports back the best price comparison for multiple days.

**How do I use `get_driver_profile` to verify a driver's trustworthiness before booking?**
You get access to detailed ratings and verification status for each driver. This tool lets you check passenger reviews and credentials, giving you confidence in the trip organizer.

**When should I use `search_trips` instead of a city name search?**
You must use `search_trips` when your pickup or dropoff point requires exact latitude and longitude. This provides maximum accuracy for pinpointing the precise location along a route.

**Does `search_bus_trips` cover all long-distance options, or just specific routes?**
It handles fixed professional bus lines operated on set schedules. Use this when carpooling isn't available or you need the reliability of a scheduled intercity coach service for longer hauls.

**How do I plan a multi-stage journey using the BlaBlaCar MCP?**
You run sequential searches. First, use `search_trips` or `search_trips_by_city` for the initial leg, then repeat the process with different date parameters to map out your entire itinerary.

**Can I book rides directly through this MCP server?**
This MCP server provides search, comparison, and driver verification tools. Booking requires redirecting to the BlaBlaCar website or app via the trip link returned in search results. The agent can find the perfect ride, but final booking happens on BlaBlaCar's platform for security.

**Does this work for international trips between countries?**
Yes! BlaBlaCar operates across 22 countries including France, Spain, Italy, Germany, Brazil, Mexico, India, and more. The search_international_trips tool lets you filter by country codes for cross-border rides. Perfect for Europe where BlaBlaCar has extensive international networks.

**How do I get a BlaBlaCar API key?**
BlaBlaCar provides API access through partnerships. Contact BlaBlaCar's developer relations team or check if you have access through aggregator services like TripGo. For testing, you can explore public API documentation and request access via their developer portal.