# Monthly Expense Total AI Agent Connect

> Monthly Expense Total MCP lets your AI client manage and analyze your monthly outflows. You can log new costs, check your total spending for any month, or see exactly where your money went by looking at category breakdowns. It turns your chat interface into a functional budgeting tool.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_RUIuebFdXu0LMLCPVP3qHalRIOPZ8H1iuODeLVOM/ai-agent-connect
- **Tags:** expenses, budgeting, finance, tracking, monthly

## Description

You can stop manually updating spreadsheets to keep track of your money. This MCP gives your AI client the ability to act as a personal bookkeeper. When you spend money, you just tell your agent what happened, and it logs the entry for you. 

Instead of digging through bank statements, you can ask your AI client for a summary of your spending for any given month. It can pull together every transaction to give you a total sum or break down your costs by category so you can see if you're overspending on groceries or rent. If you need to see the specifics of a certain category, your agent can pull that list instantly. It's a direct way to turn your natural language conversations into structured financial data.

## Tools

### add_expense
Records a new expense into your tracking system. Just tell your AI client the amount, category, and date.

### get_category_distribution
Provides a breakdown of spending across all categories for a specific month. Use this to see your percentage spend per category.

### get_monthly_total
Calculates the total sum of all expenses for a specific month and year. It gives you one final number for your budget.

### list_expenses_by_category
Retrieves a list of all expenses that fall under a specific category. This helps you audit specific spending areas.

## Prompt Examples

**Prompt:** 
```
Add an expense of 50 dollars for Groceries on 2024-05-15.
```

**Response:** 
```
The expense of $50.00 for Groceries has been successfully recorded.
```

**Prompt:** 
```
What was my total spending in March 2024?
```

**Response:** 
```
Your total spending for March 2024 was $1,250.00 across 12 expenses.
```

**Prompt:** 
```
Show me all my expenses for the Rent category.
```

**Response:** 
```
You have 3 expenses in the Rent category: $1200.00 on 2024-01-01, $1200.00 on 2024-02-01, and $1200.00 on 2024-03-01.
```

## Capabilities

### Expense Logging
Your agent records new transactions as you describe them in chat.

### Monthly Totals
The AI calculates the sum of all costs for a specific month and year.

### Category Auditing
Your agent pulls a list of every transaction within a specific category.

### Spending Distribution
The tool generates a breakdown of how much you spent in each category for a month.

## Use Cases

### Daily Expense Logging
Tell your agent you just spent money on lunch, and it logs the entry immediately.

### Monthly Budget Review
Ask for your total spending at the end of the month to see if you stayed on track.

### Category Deep Dives
Request a list of all entertainment expenses to see where your discretionary income went.

### Spending Pattern Analysis
Use the category distribution tool to see which areas of your life cost the most each month.

## Benefits

- Eliminates manual spreadsheet entry by using natural language.
- Provides instant totals for any month you specify.
- Organizes spending into clear categories for easier review.
- Works directly inside your existing AI client workflow.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to your financial logs.

1. Connect the Monthly Expense Total MCP to your AI client via Vinkius.
2. Tell your agent to record a new expense with the amount and category.
3. Ask your agent for a total or a category breakdown when you need data.
4. Review the calculated sums and lists directly in your chat window.

## Frequently Asked Questions

**How do I add an expense?**
You simply tell your AI client the details, such as the amount, the category, and the date, and it uses the add_expense tool to log it.

**Can I see my total spending for a specific month?**
Yes, you can ask your agent for the total spending of any month and year, and it will use the get_monthly_total tool to find the sum.

**Does this MCP work with Claude or Cursor?**
Yes, this MCP is compatible with any MCP-compatible client, including Claude, Cursor, and Windsurf.

**How can I see a breakdown of my spending?**
You can ask your agent for a category distribution, which provides a breakdown of all spending across your categories for a specific month.

**Can I view individual items in a category?**
Yes, you can ask your agent to list all expenses for a specific category to see the individual entries.

**How do I add a new expense?**
You can use the `add_expense` tool by providing the amount, category, date, and an optional description.

**Can I see how much I spent on food last month?**
Yes, you can use `list_expenses_by_category` for the 'Food' category or `get_category_distribution` to see the breakdown for that month.

**How do I get my total spending for January 2024?**
Use the `get_monthly_total` tool with month 1 and year 2024.