# EV Charging Stop Planner MCP. AI Agent Connect

> EV Charging Stop Planner MCP handles the math for your electric vehicle journeys. It calculates exactly where you need to stop, how long you'll stay at a charger, and whether your car's plug will actually fit the station. Your AI client uses this to build a reliable itinerary that respects your battery's reserve limits.

## Overview
- **Category:** transportation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_rP34ICjHLBjOKlPMs4qo30LE5mu9vbqv6URfCBOH/ai-agent-connect
- **Tags:** ev, charging, routing, electric-vehicle, energy

## Description

Planning a long trip in an electric vehicle usually means constant anxiety about range and charger availability. This MCP removes that guesswork. You can give your AI client a list of trip legs and your vehicle's battery specs, and it will generate a logical sequence of charging stops. It doesn't just pick random spots; it ensures you always maintain your required battery reserve so you never get stranded. 

Beyond just finding stops, the MCP helps you manage your time and budget. It can check if a specific charger is compatible with your car's connector type and pull pricing data to see what a session will cost. If you're on a tight schedule, it can calculate exactly how many minutes you'll need to sit at a station to hit your target energy level. It turns a complex logistics problem into a simple, actionable itinerary that your agent can manage for you.

## Tools

### validate_connector_compatibility
This tool checks if your specific vehicle can actually use a given charger. It compares your car's plug type against the station's available connectors.

### calculate_stop_duration
This tool tells you how long you'll be stuck at a station. It calculates the time needed to reach a specific energy level based on the charger's power output.

### get_charger_details
This tool pulls specific data for a single charging station. You'll get details on pricing, power rates, and available capabilities.

### plan_charging_stops
This tool builds an ordered list of stops for your entire trip. It uses your battery capacity and required reserve to decide where to stop and for how long.

## Prompt Examples

**Prompt:** 
```
Plan a trip with 50kWh initial SoC, 75kWh capacity, 10kWh reserve, and these legs: [{'distanceKm': 100, 'energyRequiredKwh': 20}, {'distanceKm': 150, 'energyRequiredKwh': 30}]. Here are the chargers: [{'chargerId': 'C1', 'connectorTypes': ['CCS'], 'maxRateKw': 50, 'pricePerKwh': 0.3}]. My connector is CCS.
```

**Response:** 
```
Your optimal stop is at charger C1. You will add 20kWh of energy, which will cost $6.00, and arrive at your destination with 20kWh remaining.
```

**Prompt:** 
```
How long will it take to add 30kWh if the charger provides 60kW and efficiency is 0.9?
```

**Response:** 
```
It will take approximately 33.33 minutes to complete the charge.
```

**Prompt:** 
```
Is a NACS connector compatible with a charger that has ['CCS', 'CHAdeMO']?
```

**Response:** 
```
No, the NACS connector is not compatible with the available connector types.
```

## Capabilities

### Route Planning
Your agent uses this to create a sequence of stops that keeps your battery above a safe reserve.

### Hardware Verification
The AI checks connector types to prevent you from arriving at a station you can't use.

### Cost Estimation
Your agent pulls pricing data to predict how much each charging session will cost.

### Time Management
The AI calculates the exact duration of each stop so you can plan your arrival times.

## Use Cases

### Road Trip Planning
Input your battery capacity and trip distance to get a full itinerary of charging stops.

### Budgeting for Travel
Use charger pricing data to estimate the total electricity cost for a long journey.

### Schedule Optimization
Calculate how long you need to stay at a station to ensure you can reach the next leg of your trip.

### Vehicle Compatibility Checks
Verify if a specific charger's plug type matches your vehicle before adding it to your route.

## Benefits

- Maintains a set battery reserve to prevent running out of power.
- Prevents wasted trips by verifying connector compatibility before you arrive.
- Reduces idle time by calculating exact charging durations.
- Provides clear cost estimates for each stop on the route.

## How It Works

Connect the MCP to your AI client and start planning trips immediately.

1. Connect your preferred AI client to the Vinkius-hosted MCP.
2. Provide your vehicle's battery capacity and required reserve to your agent.
3. Give your agent the trip distance and available charging station data.
4. The agent uses the tools to calculate stops, costs, and durations.
5. Receive a complete, ordered charging itinerary.

## Frequently Asked Questions

**How does this MCP prevent me from running out of battery?**
The plan_charging_stops tool uses a requiredReserve parameter to ensure your battery never drops below a specific threshold during the trip.

**Can I use this with any AI client?**
Yes, this MCP works with any client that supports the Model Context Protocol, such as Claude, Cursor, or Windsurf.

**Does it check if my car's plug will fit the charger?**
Yes, the validate_connector_compatibility tool specifically checks if your vehicle's connector type is compatible with a station's available plugs.

**How does it calculate how long I'll be at a charger?**
The calculate_stop_duration tool uses the charger's power rate and your target energy level to estimate the time required.

**Where is the MCP hosted?**
Vinkius hosts and manages the MCP, so you don't have to set up any local environments or manage credentials yourself.

**How does the planner ensure I don't run out of battery?**
The `plan_charging_stops` tool uses a mandatory `requiredReserve` parameter to ensure the battery level never drops below your specified safety threshold.

**Can I check if a specific charger works with my car?**
Yes, you can use the `validate_connector_compatibility` tool to compare your vehicle's connector type against the available options at a station.

**Does the tool account for charging speed?**
Yes, the system considers the effective charging rate and efficiency when calculating how long you will need to stay at a stop using `calculate_stop_duration`.