# Car-Share Trip Settlement AI Agent Connect

> Car-Share Trip Settlement MCP handles the math behind shared vehicle expenses. Your AI client uses this to aggregate trip costs, distribute those costs to participants based on specific rules, and figure out the fewest number of transfers needed to settle all debts. It also checks your trip data for logical errors before any math happens.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_UnbXtSY4kfoNEb2pN6MqiXoPo7LJQryLV9wQ0f7G/ai-agent-connect
- **Tags:** car-sharing, settlement, cost-splitting, trip-management, logistics

## Description

You can stop manually calculating who owes what after a shared ride. This MCP gives your AI agent the specific tools needed to manage vehicle cost redistribution. Instead of you running numbers in a spreadsheet, your agent uses this MCP to pull raw trip data into a single total, split that total among drivers and riders, and then create a clear plan for settling balances. It handles the heavy lifting of finding the most efficient way to move money between users so you aren't sending ten different small payments when three would do. Before it processes any numbers, it validates your trip metadata to make sure the distance, time, and participant counts actually make sense. It's a direct way to turn messy trip logs into clean, actionable settlement instructions.

## Tools

### allocate_participant_costs
This tool splits the total trip cost among all participants using your defined rules. It handles the math for both drivers and riders.

### calculate_trip_totals
This tool aggregates raw trip data into one final cost figure. It sums up fuel, fees, and other trip expenses.

### generate_settlement_plan
This tool identifies the specific transfers required to zero out all participant balances. It finds the most efficient way to settle debts.

### validate_trip_metadata
This tool checks that your trip details are logically consistent. It prevents processing if the data is nonsensical.

## Prompt Examples

**Prompt:** 
```
Calculate the total cost for a trip with 50km distance, 20 USD fuel cost, and 10 USD usage fees.
```

**Response:** 
```
The total cost for the trip is 30 USD.
```

**Prompt:** 
```
Find the minimum transfers for these balances: UserA: -10, UserB: 5, UserC: 5.
```

**Response:** 
```
UserA should transfer 5 to UserB and 5 to UserC.
```

**Prompt:** 
```
Validate a trip with 10km, 15 minutes, and 2 participants.
```

**Response:** 
```
The trip metadata is valid.
```

## Capabilities

### Cost Aggregation
Your agent sums up all raw trip data into a single total.

### Participant Cost Splitting
The AI distributes costs to drivers and riders based on specific rules.

### Debt Minimization
The agent identifies the fewest number of transfers needed to settle all balances.

### Data Validation
The AI checks trip metadata for logical consistency before calculating totals.

## Use Cases

### Corporate Car-Pooling
An agent calculates the total fuel and usage costs for employees sharing a vehicle and splits the bill.

### Fleet Expense Management
A manager uses the MCP to aggregate multiple trip costs and generate settlement plans for drivers.

### Peer-to-Peer Car Sharing
Users settle debts between riders and drivers using the most efficient transfer paths.

### Trip Data Auditing
The AI validates trip metadata to ensure distance and time entries are consistent with the costs reported.

## Benefits

- Reduces the number of individual transfers needed to settle debts.
- Prevents errors by validating trip data before processing costs.
- Automates the math of splitting costs between different types of participants.
- Converts raw trip logs into clear payment instructions.

## How It Works

Connect your AI client to Vinkius to start running settlement math.

1. Connect your MCP-compatible client to the Vinkius hosted MCP.
2. Provide your trip data to your AI agent.
3. The agent validates the trip metadata for consistency.
4. The agent calculates total costs and distributes them to participants.
5. The agent generates a final settlement plan with specific transfer instructions.

## Frequently Asked Questions

**How does this MCP handle debt settlement?**
It uses the generate_settlement_plan tool to find the most efficient way to zero out all participant balances with the fewest transfers.

**Can I use this with Claude or Cursor?**
Yes, you can connect this MCP to any MCP-compatible client like Claude, Cursor, or Windsurf through Vinkius.

**What happens if my trip data is incorrect?**
The validate_trip_metadata tool checks for logical consistency in your trip details before any calculations are performed.

**Does this MCP host the data?**
Vinkius hosts and manages the MCP, so you don't need to run it locally or manage the infrastructure yourself.

**Can it split costs differently for drivers and riders?**
Yes, the allocate_participant_costs tool distributes the total trip cost among participants based on specific rules.

**How are trip costs calculated?**
Costs are aggregated using the `calculate_trip_totals` tool, which sums fuel expenses and usage fees.

**Can I use custom split rules?**
Yes, the `allocate_participant_costs` tool supports both equal splits and weighted splits based on user-provided weights.

**What is a settlement plan?**
A settlement plan is a list of the minimum number of transfers required to zero out all participant balances, generated by `generate_settlement_plan`.