# Oshi Budget Allocator AI Agent Connect

> A deterministic budget tool for Oshi fans to balance fixed costs and discretionary spending.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qaVPB1q7bWU58pHci3RX6Rw8ORUN6amuxiNKQllx/ai-agent-connect
- **Tags:** budget, oshi, vtuber, allocation, finance-tool

## Description

Manage your monthly fan spending with precision. This MCP server helps Oshi fans (idol/VTuber enthusiasts) allocate a fixed monthly budget across various categories like merchandise and super chats. By using the `calculate_allocation` tool, you can ensure all mandatory fixed costs are covered first, then distribute the remaining funds based on your specific category priorities. You can also use `get_spending_summary` to see your total committed versus available funds at a glance.

## Tools

### calculate_allocation
Calculates the exact distribution of funds across all specified spending categories

### get_spending_summary
Provides a high-level view of the total committed versus total available funds

### validate_category_integrity
Ensures that the provided categories and their specific costs are logically sound

## Prompt Examples

**Prompt:** 
```
Allocate a 50,000 JPY budget for my Oshi. Categories: merchandise (priority 5, fixed 10,000 JPY), super_chats (priority 3, fixed 5,000 JPY), and streaming_membership (priority 2, fixed 2,000 JPY).
```

**Response:** 
```
Your allocated amounts are: merchandise: 31,000 JPY, super_chats: 13,000 JPY, and streaming_membership: 6,000 JPY. You have 0 JPY remaining.
```

**Prompt:** 
```
Show me a summary for a 20,000 JPY budget with merchandise (priority 4, fixed 15,000 JPY) and event_tickets (priority 1, fixed 10,000 JPY).
```

**Response:** 
```
Total fixed costs are 25,000 JPY. Since this exceeds your 20,000 JPY budget, you are in a deficit.
```

**Prompt:** 
```
Check if my category list is valid: merchandise (priority 5, fixed 5000) and super_chats (priority 3, fixed -100).
```

**Response:** 
```
The category integrity check failed because a fixed cost cannot be a negative value.
```

## Frequently Asked Questions

**How does the budget distribution work?**
The tool first deducts all fixed costs. The remaining budget is then distributed among categories based on their assigned priority (1-5) using a weighted method.

**What happens if my fixed costs exceed my budget?**
The `calculate_allocation` tool will trigger an overspend flag, indicating that your mandatory costs have already exceeded your total monthly budget.

**Can I use this with Cursor or Claude Desktop?**
Yes, you can connect this MCP server to Cursor, Claude Desktop, VS Code, Windsurf, and any other MCP-compatible client via Vinkius Edge.