# Hiveage MCP

> Hiveage MCP automates your entire billing cycle directly through natural conversation. Manage invoices, track payments, create estimates, and handle customer records without ever navigating a web portal. It brings the full power of Hiveage's financial tools into your AI agent, letting you process complex accounting tasks—from listing overdue accounts to sending out updated invoices—all with simple chat commands.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** invoicing, estimates, time-tracking, expense-management, financial-reporting

## Description

Stop clicking through confusing tabs just to check an invoice status or record a payment. This connector gives your AI client full control over the core functions of Hiveage, treating it like a dedicated Accounts Receivable specialist sitting right next to you. You use plain English to list all outstanding invoices, grab detailed information using unique keys, and even manually log payments against specific bills. Need to send an invoice? Just ask, and it delivers the document via email. It’s how you keep your billing process fluid, whether you're a freelancer chasing late payments or a small business owner managing complex estimates. Because this MCP is hosted on Vinkius, you can connect your preferred AI client once and gain access to this entire suite of financial tools alongside thousands of others. You never have to manually jump between tabs again.

## Tools

### record_payment
Logs a manual payment against an invoice, requiring the amount, date, and payment method.

### send_invoice_email
Emails a specific invoice document directly to the customer's address.

### get_customer_details
Retrieves full profile and connection information for any listed customer or vendor.

### get_estimate_details
Gets comprehensive details about a specific client quote using its unique identifier.

### get_invoice_details
Retrieves the complete billing breakdown and status for a particular invoice.

### get_api_profile
Pulls basic information about the authenticated Hiveage account itself.

### list_estimates
Generates a list of all active and past client quotes stored in your Hiveage account.

### list_invoices
Displays an overview of every invoice in the account, providing hash keys for deeper actions.

### list_billing_items
Lists all services and items you have saved to use when creating or updating invoices.

### list_customers
Provides an overview of every contact, including both customers and vendors, in your network.

### list_invoice_payments
Shows a full list of all payments recorded specifically for one invoice number.

### list_tax_profiles
Displays every configured tax rate and profile used in your billing system.

## Prompt Examples

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

**Response:** 
```
I've retrieved your unpaid invoices. You have 3 pending documents: INV-102 ($450.00), INV-105 ($1,200.00), and INV-110 ($300.00). All are marked as 'SENT' or 'OVERDUE'. Would you like 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. The new balance has been 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. It was sent to 'Acme Corp' last Tuesday and is currently in 'PENDING' status. Would you like to convert this estimate into an invoice?
```

## Capabilities

### Check Billing Status
List all invoices and retrieve specific billing records using unique hash keys.

### Manage Estimates
Access, view details, and list your history of client quotes or estimates.

### Record Payments
Manually log payments (cash, check, etc.) directly against any existing invoice.

### Client Data Lookup
Get detailed profile information for specific customers or vendors in your network.

### Deliver Documents
Send a finalized invoice to a customer using their email address with one command.

## Use Cases

### The Overdue Accounts Problem
A small business owner needs to know which clients haven't paid since last month. They ask their agent to run `list_invoices` and filter for 'OVERDUE'. The system responds with the list of unpaid invoices, allowing them to immediately send out reminders using `send_invoice_email`.

### Quick Payment Logging
A freelancer gets a $500 cash payment and needs to log it. They prompt their agent: 'Record the payment for invoice key kiLDAgtGzNpaAQ.' The tool executes `record_payment`, updates the balance, and confirms the new status.

### Converting Quotes to Bills
A client signs off on a quote. Instead of manually creating an invoice from the estimate, the agent uses `get_estimate_details` and then prompts: 'Convert this estimate to an invoice.' The process is finished in conversation.

### Auditing Tax Compliance
An accountant needs to check if all projects are billed at the correct tax rate. They ask the agent to `list_tax_profiles` and cross-reference it with `list_billing_items` before finalizing any large batch of invoices.

## Benefits

- Stop wasting time on manual data entry. You can use the `record_payment` tool to log cash or check payments against an invoice instantly, without opening a separate banking portal.
- Never lose track of client deals again. Use `list_estimates` and `get_estimate_details` to keep your entire quoting history visible in chat, letting you know exactly which quotes are pending conversion.
- Streamline document delivery. Instead of logging into the site to hit 'send,' simply ask the agent to execute `send_invoice_email`, and it handles the attachment and mailing process for you.
- Maintain data accuracy. Before billing, use `list_tax_profiles` or `list_billing_items` to pull up accurate tax rates and service descriptions, guaranteeing your invoices are always correct.
- Get a 360-degree view of clients. Use `list_customers` and `get_customer_details` to quickly verify contact information or check the full history for any client in minutes.

## How It Works

The bottom line is that instead of clicking through menus and filling out forms on the Hiveage website, you just ask your AI client a question in natural language.

1. Subscribe to the Hiveage MCP and provide your API key and subdomain credentials.
2. Connect this MCP to any AI-compatible client, like Claude or Cursor.
3. Start talking to your agent: simply tell it what you need—for example, 'Show me all unpaid invoices'—and the system handles the rest.

## Frequently Asked Questions

**How do I check all outstanding invoices using Hiveage MCP?**
You use the `list_invoices` tool to get a comprehensive overview of every invoice in your account. This list provides key hash identifiers, which you can then pass to other tools for deeper status checks.

**Can I record payments using Hiveage MCP?**
Yes. You use the `record_payment` tool and must provide three pieces of information: the exact amount, the date it was received, and the payment method (e.g., cash or check).

**What is the difference between listing estimates and invoices?**
Estimates are quotes for future work, which you view using `list_estimates`. Invoices are official bills for services already rendered, which you manage using `list_invoices`.

**How do I get a client's contact information?**
Use the `get_customer_details` tool to retrieve all profile and connection data associated with any customer or vendor name in your network.

**Can Hiveage MCP send an invoice via email?**
Yes, you can execute `send_invoice_email`. This command sends the specific invoice document to the customer's listed email address directly from the agent.