# Fuel Economy Log Analysis AI Agent Connect

> Fuel Economy Log Analysis MCP lets your AI client process chronological fueling records to calculate efficiency, cost per distance, and performance trends. Instead of manually crunching numbers from receipts or spreadsheets, you can ask your agent to aggregate data over specific timeframes or compare current performance against previous periods to see exactly how your vehicle's efficiency is changing.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_w0j2xXqDutwsRVeN90dX3ITFAf1GzDS3ZsjWvLJD/ai-agent-connect
- **Tags:** fuel-efficiency, vehicle-tracking, cost-analysis, log-management, automotive-data

## Description

You can stop manually calculating fuel costs and efficiency math. This MCP gives your AI client direct access to your fueling history so it can handle the heavy lifting of data analysis. You can use it to track how much you're spending per mile, how your fuel economy fluctuates between trips, and how your vehicle's performance trends over months or years. Whether you're managing a single vehicle or a small fleet, your agent can now pull specific refueling events or aggregate data into clean summaries. It turns raw logs into clear insights about cost per distance and period-over-period changes, making it easy to spot when efficiency drops or costs spike.

## Tools

### get_fill_up_summary
This tool provides a detailed list of individual fueling events and the efficiency achieved during each interval.

### get_performance_trends
This tool compares current efficiency and cost against the most recent prior period to show changes.

### get_period_metrics
This tool calculates aggregated fuel efficiency and cost metrics over a specific timeframe.

### search_fuel_logs
This tool lets you search for specific fueling events using date ranges or minimum volume thresholds.

## Prompt Examples

**Prompt:** 
```
Show me the fuel efficiency summary for vehicle V123.
```

**Response:** 
```
The fuel efficiency for vehicle V123 shows an average efficiency of 12.5 km/L across 5 recorded fill-ups.
```

**Prompt:** 
```
What were my fuel metrics between 2024-01-01 and 2024-01-31 for vehicle V123?
```

**Response:** 
```
For the period 2024-01-01 to 2024-01-31, the vehicle covered 1,200 km with a total fuel consumption of 100L, resulting in an efficiency of 12 km/L and a cost per distance of $0.15/km.
```

**Prompt:** 
```
Compare my fuel performance for the last 30 days against the previous 30 days for vehicle V123.
```

**Response:** 
```
Your fuel efficiency improved by 5% compared to the previous 30-day period, and your cost per distance decreased by $0.02/km.
```

## Capabilities

### Efficiency Calculation
Your agent calculates fuel economy per interval based on fueling records.

### Cost Analysis
The AI determines your cost per distance over specific timeframes.

### Trend Comparison
Your client compares current performance metrics against previous periods.

### Log Filtering
The agent searches through logs using dates or fuel volume thresholds.

### Data Aggregation
Your AI client summarizes fuel data into specific time-based metrics.

## Use Cases

### Monitoring Efficiency Drops
Ask your agent to compare recent performance to previous periods to see if fuel economy is declining.

### Budgeting Fuel Costs
Use period metrics to see exactly how much you spent on fuel during a specific month.

### Auditing Fueling Events
Search for specific large-volume refueling events to verify log accuracy.

### Vehicle Performance Tracking
Get a summary of efficiency for a specific vehicle over its entire recorded history.

## Benefits

- Eliminates manual math by letting your agent calculate efficiency and cost per distance.
- Identifies performance shifts through period-over-period trend comparisons.
- Speeds up data retrieval with specific log searches based on volume or date.
- Provides instant summaries of fueling events and aggregated period metrics.

## How It Works

Setting up this MCP is a one-time process that gives your AI client immediate access to your fuel data.

1. Subscribe to the MCP on Vinkius.
2. Connect your preferred client like Claude or Cursor with one click.
3. Ask your agent to search or analyze your fuel logs.
4. Receive calculated efficiency, cost, and trend data directly in your chat.

## Frequently Asked Questions

**How do I connect this MCP to my AI client?**
You connect once through the Vinkius platform. Vinkius hosts the MCP and manages the connection so you can use it in Claude, Cursor, or Windsurf immediately.

**Can I analyze fuel costs for a specific month?**
Yes. You can use the period metrics tool to get aggregated fuel efficiency and cost data for any specific timeframe you define.

**Does this MCP work with my existing fuel logs?**
This MCP processes chronological fueling records to provide efficiency, cost, and trend analysis.

**Can I compare my current fuel economy to last month?**
Yes. The performance trends tool is designed to compare current period efficiency and cost against the most recent prior period.

**Can I filter logs by how much fuel I bought?**
Yes. The search tool allows you to filter fueling events based on minimum volume thresholds or date ranges.

**How is fuel efficiency calculated?**
Efficiency is determined by the distance traveled between two consecutive fill-ups divided by the volume of fuel required to refill the tank.

**Can I compare my fuel costs between different months?**
Yes, you can use `get_performance_trends` to compare the current period's efficiency and cost against the most recent prior period.

**What data is required to use these tools?**
The tools require a valid `vehicleId` and, for period-based queries, specific ISO 8601 date ranges.