# Hiveage MCP for AI Agents AI Agent Connect

> Hiveage MCP lets you manage invoices, estimates, and payments from your AI agent. Instead of clicking through billing tabs, you can ask your agent to send emails, check payment statuses, or record new deposits. It connects your Hiveage account to your favorite AI client so you can handle the boring side of finance through a simple chat interface.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Z6jqmFZwIRSbwyNJjn2mieGyIcTev6GZ6TgBUKq8/ai-agent-connect
- **Tags:** invoicing, estimates, time-tracking, expense-management, financial-reporting

## Description

This Connector lets you connect your Hiveage account to any AI agent and take full control of your online invoicing, estimates, and customer network through natural conversation. Instead of jumping between tabs to find a specific invoice or manually typing out payment details, you can just ask your agent to do the heavy lifting. You can pull a list of all unpaid bills, get the status of a specific quote, or send a reminder to a customer who's late on their payment. It turns your AI client into a dedicated accounts receivable specialist. By using this Connector through the Vinkius catalog, you get a direct way to manage your finances without the usual friction of a web dashboard. It's about moving from manual data entry to just giving directions.

## Tools

### list_billing_items
list_billing_items shows the services and products you have saved. Use this to make sure your quotes stay consistent across different clients.

### send_invoice_email
send_invoice_email sends a bill to a customer's inbox instantly. It saves you from having to copy and paste email addresses manually.

### get_customer_details
get_customer_details pulls the profile for a specific customer or vendor. Use it to see who you're dealing with without leaving your chat.

### get_estimate_details
get_estimate_details lets you see the specifics of a single quote. Use it to review exactly what a client was promised before you start work.

### get_invoice_details
get_invoice_details pulls the full data for a single bill. It's perfect for checking the status and total of a specific payment.

### get_api_profile
get_api_profile shows your current account information. It's a quick way to check if your connection is active and correct.

### list_estimates
list_estimates pulls every quote in your account into one view. You can use this to keep your sales pipeline organized.

### list_invoices
list_invoices gives you a full list of all your bills. It's the best way to monitor your outstanding debt and find specific hash keys.

### list_customers
list_customers shows every connection in your business network. Use this to manage your full contact list from your AI client.

### list_invoice_payments
list_invoice_payments shows every payment linked to a specific bill. This helps you track partial payments or multiple deposits easily.

### list_tax_profiles
list_tax_profiles pulls your tax settings into the chat. Use this to double-check rates so every invoice is accurate.

### record_payment
record_payment lets you log a new deposit against an invoice. You can record amounts and dates without ever opening your billing dashboard.

## Prompt Examples

**Prompt:** 
```
List all unpaid invoices and their total amounts.
```

**Response:** 
```
I've retrieved your unpaid invoices. You have 3 pending documents:

| Invoice | Amount | Status |
| :--- | :--- | :--- |
| INV-102 | $450.00 | OVERDUE |
| INV-105 | $1,200.00 | SENT |
| INV-110 | $300.00 | SENT |

Would you like me to send a reminder for the overdue invoice?
```

**Prompt:** 
```
Record a cash payment of $500 for invoice hash 'kiLDAgtGzNpaAQ'.
```

**Response:** 
```
Payment recorded! I've successfully logged a $500.00 cash payment for invoice **kiLDAgtGzNpaAQ**. 

*   **New Balance:** Updated
*   **Status:** Updated in Hiveage

Should I also deliver the updated invoice to the customer?
```

**Prompt:** 
```
Show me the details for the estimate with key 'ests_992'.
```

**Response:** 
```
Accessing estimate details... 

**Estimate ests_992** is for **'Website Redesign'** totaling **$2,500.00**. 

*   **Sent to:** Acme Corp
*   **Date:** Last Tuesday
*   **Status:** PENDING

Would you like to convert this estimate into an invoice?
```

## Capabilities

### Send invoices via email
Your agent sends bills directly to customers with one command.

### Record manual payments
Log deposits against specific invoices to keep your balances current.

### View estimate details
Pull the specifics of a quotation to review what a client was promised.

### List all customers
See every connection in your business network in one view.

### Check tax profiles
Verify your configured tax settings to ensure every bill is accurate.

### Monitor invoice statuses
Get a full list of your bills to see what's outstanding or paid.

## Use Cases

### Logging a quick deposit
A freelancer gets a $500 check and asks their agent to record a cash payment for invoice kiLDAgtGzNpaAQ. The agent logs it and updates the balance.

### Automated overdue reminders
A business owner asks their agent to list all unpaid invoices and send a reminder to everyone who's overdue. The agent handles the emails in seconds.

### Month-end reconciliation
An accountant asks the agent to list all tax profiles and billing items to prepare for the end of the month. They get the full data without opening a browser.

### Reviewing a pending deal
A project manager asks for the details of a specific estimate to check the total amount and status. The agent pulls the info for 'Website Redesign' immediately.

## Benefits

- Stop manual data entry by using record_payment to log deposits instantly.
- Save time on follow-ups by using send_invoice_email to reach clients from your chat.
- Keep your quotes accurate by checking list_billing_items and list_tax_profiles before sending.
- Get a bird's-eye view of your debt by using list_invoices to see every open bill.
- Stay organized with your pipeline by pulling list_estimates to see pending deals.
- Know your clients better by using get_customer_details to see connection history.

## How It Works

The bottom line is you stop tab-switching and start managing your money through conversation.

1. Subscribe to the Hiveage MCP on Vinkius.
2. Enter your Hiveage API Key and Subdomain in your AI client.
3. Start asking your agent to pull reports or send billing updates.

## Frequently Asked Questions

**How does the Hiveage MCP help with my daily billing?**
It lets you manage your invoices and estimates through a simple chat. You can ask your agent to pull lists of unpaid bills, check the status of a quote, or send out invoices without ever opening a web browser.

**Can I use the Hiveage MCP to send invoices to my customers?**
Yes, you can. Your AI agent can send invoices directly to your customers' email addresses using a single command, saving you the time of manual data entry.

**Will the Hiveage MCP keep my payment records up to date?**
Absolutely. You can tell your agent to log a new payment against a specific invoice, and it will update your Hiveage account balance immediately.

**Is the Hiveage MCP good for tracking my sales pipeline?**
It's great for that. You can ask your agent to list all your current estimates and quotations to see which deals are pending and what's coming up next.

**Can the Hiveage MCP help with tax accuracy?**
Yes, it can pull your configured tax profiles into the chat. This allows you to verify that the correct tax rates are being applied before you send out a bill.

**Do I need to be an accountant to use the Hiveage MCP?**
Not at all. It's designed for freelancers and small business owners who want a simpler way to handle their billing and payments through natural conversation.

**How do I find my Hiveage API Key?**
Log in to your Hiveage account, go to **Settings > API**, and you will find your unique API key there. This key is used as the username for Basic Authentication.

**What is the Hiveage 'Subdomain'?**
The subdomain is the unique part of your Hiveage URL (e.g., if you access Hiveage at `mycompany.hiveage.com`, your subdomain is `mycompany`).

**Can I record a partial payment for an invoice?**
Yes! When using the `record_payment` tool, you can specify any amount in the `body_json`. Hiveage will automatically update the invoice balance based on the recorded payment.

**Is the integration secure for financial data?**
Absolutely. The integration uses official Hiveage API keys over HTTPS. Your credentials and billing data are encrypted and stored securely within the Vinkius Cloud infrastructure.