# Bill Payment Analyzer AI Agent Connect

> Bill Payment Analyzer lets your AI agent process collections of bill records to find exactly what you owe. It handles the math for counting paid versus unpaid bills, calculating total outstanding debt, and determining your payment completion rate. Instead of manually scanning spreadsheets, you can just ask your AI client for a summary of your current liabilities.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_CGxpXFgO4nr5kAYq6CRKHdzeZoJNuEL02GRnYsrl/ai-agent-connect
- **Tags:** bills, payments, accounting, finance, analytics

## Description

You can stop manually tallying up unpaid invoices and outstanding balances. This MCP gives your AI agent the ability to parse through bill records and pull out the specific financial data you need. If you have a list of transactions, your agent can immediately tell you how many bills are still sitting unpaid or what the total dollar amount of your remaining debt is. 

You can use it to isolate specific records by status, making it easy to focus only on what still needs attention. It also calculates your payment completion rate, which gives you a quick look at your financial progress. Whether you are managing small business expenses or personal accounts, this tool turns raw bill data into actionable numbers without you having to touch a calculator.

## Tools

### count_bill_statuses
This tool counts how many bills in your list are marked as paid and how many are unpaid.

### filter_bills_by_status
Use this to pull out only the specific bill records that are either paid or unpaid.

### get_payment_completion_rate
This tool calculates the percentage of your total bills that have already been paid.

### get_unpaid_bill_total
This tool sums up the total dollar amount of all bills currently marked as unpaid.

## Prompt Examples

**Prompt:** 
```
How many bills have been paid in this list: [{"amountDue": 100, "amountPaid": 100}, {"amountDue": 50, "amountPaid": 0}]?
```

**Response:** 
```
There is 1 paid bill and 1 unpaid bill.
```

**Prompt:** 
```
What is the total outstanding amount for these bills: [{"amountDue": 200, "amountPaid": 50}, {"amountDue": 100, "amountPaid": 100}]?
```

**Response:** 
```
The total outstanding amount is 150.
```

**Prompt:** 
```
What is the payment completion rate for [{"amountDue": 10, "amountPaid": 10}, {"amountDue": 10, "amountPaid": 10}, {"amountDue": 10, "amountPaid": 0}]?
```

**Response:** 
```
The payment completion rate is 0.6666666666666666.
```

## Capabilities

### Status Counting
Your agent counts the volume of paid versus unpaid records.

### Liability Calculation
The AI calculates the total sum of all unpaid bills.

### Progress Tracking
Your agent determines the percentage of completed payments.

### Record Filtering
The tool isolates specific bills based on whether they are paid or unpaid.

## Use Cases

### Debt Assessment
Ask your agent for the total unpaid amount to see exactly how much cash you need to cover your bills.

### Payment Progress
Check your completion rate to see how much of your monthly obligations are finished.

### Unpaid Bill Audits
Filter your list to see only the unpaid records so you can focus on what to pay next.

### Volume Analysis
Get a quick count of paid versus unpaid items to understand your current billing cycle status.

## Benefits

- Eliminates manual math for outstanding totals.
- Provides instant status counts for large bill lists.
- Turns raw bill data into percentage-based progress metrics.

## How It Works

Connect your client to Vinkius and start sending bill data to your agent.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide a list of bill records to your AI agent.
3. Ask the agent to perform a specific calculation or filter.
4. The agent uses the MCP tools to process the data and give you the answer.

## Frequently Asked Questions

**What can this MCP do with my bill data?**
It allows your AI agent to count bill statuses, calculate unpaid totals, find payment completion rates, and filter bills by status.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you. You just connect your client and it is ready to use.

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

**Can it calculate how much I still owe?**
Yes, the get_unpaid_bill_total tool calculates the total outstanding amount for all unpaid bills in your list.

**Is there a way to see only unpaid bills?**
Yes, you can use the filter_bills_by_status tool to isolate only the unpaid records.

**How is a bill considered 'paid'?**
A bill is classified as paid if the total amount paid is equal to or greater than the amount due.

**Can I see only the bills that are still owed?**
Yes, you can use the `filter_bills_by_status` tool with the status set to 'unpaid' to retrieve those specific records.

**What information do I need to provide?**
You need to provide a JSON-stringified array of bill objects, where each object contains the amount due and the amount paid.