# Craft Night Cost Tracker AI Agent Connect

> Craft Night Cost Tracker MCP handles the messy math of organized crafting sessions. Your AI agent can log shared material costs, figure out exactly who owes what, and pull quick summaries of total spending. It turns your chat interface into a dedicated financial ledger for your hobby groups.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QCNG19swqmAmtdO6eqK4NhrPRXyQ8ghKI5Pzmoay/ai-agent-connect
- **Tags:** expense-tracking, crafting, settlement, budgeting, event-planning

## Description

Organizing a group crafting session involves more than just gathering supplies. You have to track who bought the glue, who paid for the studio rental, and how to split those costs fairly at the end. This MCP takes that burden off your plate. Instead of manual spreadsheets, you just tell your AI client what was spent. You can log individual supplies or shared facility fees as they happen. When the session ends, your agent calculates the balances for every participant, so you know exactly how much to send or receive to settle up. It keeps your hobby organized so you can focus on the actual crafting.

## Tools

### get_session_summary
This tool provides a high-level financial overview of a single crafting session. Use it to see the total spend at a glance.

### list_session_expenses
This tool pulls a detailed, itemized list of every cost recorded during a session. It's useful for auditing specific purchases.

### add_expense
This tool logs a new cost to a specific crafting session. You can use it to record everything from shared materials to venue fees.

### calculate_participant_balances
This tool determines the exact amounts each person owes or is owed. It handles the math to settle all session debts.

## Prompt Examples

**Prompt:** 
```
Add a 25 dollar expense for shared glue to session session_123, paid by Alice.
```

**Response:** 
```
The expense of $25.00 for shared glue has been recorded for session session_123.
```

**Prompt:** 
```
What is the total spent in session session_456?
```

**Response:** 
```
The total spent in session session_456 is $142.50.
```

**Prompt:** 
```
Show me all the expenses for session session_789.
```

**Response:** 
```
There are 4 expenses recorded for session session_789: $10.00 (shared_material), $5.00 (facility), $15.00 (individual_supply), and $20.00 (facility).
```

## Capabilities

### Expense Logging
Your agent records costs for materials and facilities as they occur.

### Debt Settlement
The MCP calculates how much each person needs to pay or receive to balance the books.

### Financial Auditing
You can request itemized lists of every single purchase made during a session.

### Spending Summaries
Your AI client can provide a quick total of all money spent for a specific event.

## Use Cases

### Shared Material Tracking
Log the cost of bulk yarn or clay bought by one person for the whole group.

### Venue Fee Management
Record studio or community center rental costs to be split among attendees.

### End-of-Session Settlement
Run a balance calculation to see who needs to Venmo whom after the event.

### Budget Oversight
Check the total session spend to stay within your group's hobby budget.

## Benefits

- Eliminates manual math for splitting group costs.
- Centralizes all session spending in one place.
- Provides instant settlement amounts for participants.
- Maintains a clear record of every material purchased.

## How It Works

Connect your client to Vinkius and start chatting with your agent to manage your craft night finances.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Tell your agent to add an expense for a specific session.
3. Request a summary or itemized list to check the math.
4. Ask the agent to calculate participant balances to settle debts.

## Frequently Asked Questions

**How do I add a new cost to my session?**
You just tell your AI client to use the add_expense tool, specifying the amount, the item, and the session ID.

**Can this MCP calculate how much people owe me?**
Yes, the calculate_participant_balances tool determines exactly how much each person needs to pay or receive to settle all debts.

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

**Can I see a list of everything we bought?**
Yes, you can use the list_session_expenses tool to get a full itemized breakdown of all costs.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection.

**How are shared costs split?**
Shared materials and facility costs are split equally among all participants in the session.

**Can I record costs for a specific person?**
Yes, by using the `add_expense` tool with the 'individual_supply' category and providing a `recipientId`.

**How do I know who needs to pay whom?**
You can use the `calculate_participant_balances` tool to get a list of net balances for every participant.