# Community Tool Share Balance AI Agent Connect

> Community Tool Share Balance MCP handles the financial heavy lifting for tool-sharing cooperatives. It lets your AI client track member credits, calculate rental totals with late fees, and identify who still owes money. Instead of manual spreadsheets, your agent interacts directly with the cooperative's financial records to keep accounts accurate.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_CSjazC05GisrgFoFpSq1KRJjG1IkIhJXwMl0hpBX/ai-agent-connect
- **Tags:** balance, fees, penalties, reconciliation, cooperative

## Description

Managing a tool-sharing cooperative means constantly juggling member accounts, rental fees, and late penalties. This MCP acts as a financial reconciliation engine that plugs directly into your cooperative's data. You can stop manually calculating what a member owes or checking which rentals incurred repair charges. Instead, you just ask your AI client to run the numbers. 

Your agent can pull up a member's current standing, check the total cost of a specific booking, or generate a list of everyone with an outstanding balance. It handles the math for usage fees, deposits, and penalties so you don't have to. Whether you need a quick snapshot of a single person's history or a full list of debtors, your agent gets the data instantly. It's built to keep the books clean and the community's finances transparent without the manual data entry.

## Tools

### get_member_balance
This tool checks if a specific member has a credit or an outstanding balance.

### calculate_booking_cost
Use this to find the total price for a tool rental, including any applicable late fees.

### get_member_activity_summary
This tool provides a high level overview of a member's financial history with the cooperative.

### list_pending_payments
This tool identifies all members who currently owe money to the cooperative.

## Prompt Examples

**Prompt:** 
```
What is the current balance for member M123?
```

**Response:** 
```
Member M123 currently has a balance of $15.00, meaning they owe the cooperative fifteen dollars.
```

**Prompt:** 
```
How much does booking B987 cost in total?
```

**Response:** 
```
The total cost for booking B987 is $25.00, which includes a $20.00 base fee and a $5.00 late fee.
```

**Prompt:** 
```
List all members who owe more than $50.
```

**Response:** 
```
The following members owe more than $50: Alice (Member ID: A01, Amount: $65.00) and Bob (Member ID: B02, Amount: $120.00).
```

## Capabilities

### Balance Tracking
Your agent checks real-time member credits and debts.

### Cost Calculation
The AI calculates rental totals by adding base fees and penalties.

### Debt Identification
Your agent pulls lists of members with unpaid balances.

### Financial Summaries
The AI generates historical overviews of member transactions.

## Use Cases

### Late Fee Processing
Your agent calculates the exact amount a member owes when a tool is returned past its due date.

### Debt Collection
You ask your AI client to list all members with pending payments to send out reminders.

### Member Audits
An administrator uses the activity summary tool to review a member's financial history.

### Rental Pricing
The AI determines the final cost of a rental including deposits and usage fees.

## Benefits

- Automates the math for late fees and repair charges.
- Eliminates manual searching for outstanding member debts.
- Provides instant financial snapshots through natural language.
- Centralizes usage fees and deposits into a single interface.

## How It Works

Get your cooperative's financial data into your AI client in minutes.

1. Subscribe to the MCP on Vinkius.
2. Connect your AI client like Claude or Cursor to the Vinkius host.
3. Ask your agent questions about member balances or booking costs.
4. The agent executes the specific tool to pull real-time data from the cooperative.

## Frequently Asked Questions

**What kind of cooperatives can use this MCP?**
It is built for any community tool-sharing cooperative that needs to track member accounts, fees, and penalties.

**Can the AI calculate late fees?**
Yes, the calculate_booking_cost tool includes penalties in the total price calculation.

**How do I see who owes money?**
You can use the list_pending_payments tool to identify all members with outstanding balances.

**Does this handle repair charges?**
Yes, the MCP handles usage fees, late penalties, repair charges, and deposits.

**Which AI clients work with this MCP?**
You can use any MCP-compatible client, such as Claude, Cursor, Windsurf, or VS Code.

**How is a member's balance calculated?**
The balance is the sum of all usage fees, late penalties, and repair charges, minus any deposits and previous payments made by the member. You can use `get_member_balance` to retrieve this value.

**Can I see a summary of a member's history?**
Yes, the `get_member_activity_summary` tool provides a high-level view of total fees charged, penalties incurred, and payments made over a specific period.

**How do I find members who owe money?**
You can use the `list_pending_payments` tool to get a list of all members with a positive balance (debtors).