# Wave Financial MCP MCP > Wave Financial lets your AI agent access all-in-one small business accounting data. Query specific records like customer details, current invoices, and cash flow transactions directly from Wave without logging into the dashboard. You get real-time visibility across multiple businesses just by talking to your agent. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** accounting-software, invoicing, financial-reporting, small-business-finance, transaction-tracking ## Description Connect your AI client to Wave Financial for deep access into your company's bookkeeping. Instead of navigating tabs and clicking through dashboards, you talk to your agent and it pulls the numbers you need—whether it’s checking the status of a large invoice or auditing which businesses are active. It provides real-time data across all core financial areas: from listing multiple associated businesses to tracking specific accounts payable with `list_bills`. This MCP handles everything needed for small business finance, making sure that every transaction and record is traceable. Because this entire process runs through Vinkius, your agent's actions are recorded in a cryptographically signed audit trail. You always know who accessed what data and when, which is critical when handling financial records. The result is immediate visibility into everything from sales tax configurations to current bank balances. ## Tools ### get_user_info Retrieves basic profile information about the authenticated user. ### list_accounts Gets a list of all financial accounts and categories for a specific business unit. ### list_bills Retrieves a detailed list of outstanding bills (accounts payable) for one business. ### list_businesses Lists every separate legal entity or business unit linked to your Wave account. ### list_customers Finds and lists contact details for all customers associated with a given business. ### list_invoices Generates summaries of invoices, including their payment status, total amounts, and due dates. ### list_products Lists the goods or services you sell for a specific business unit. ### list_sales_taxes Retrieves active sales tax rates and configurations used by the business. ### list_transactions Lists all recorded accounting transactions, providing a history of cash flow for a business. ### list_vendors Finds and lists the contact information for your suppliers (vendors). ## Prompt Examples **Prompt:** ``` List my businesses in Wave. ``` **Response:** ``` You have 2 businesses: 'Design Studio' (ID: 123) and 'E-commerce Shop' (ID: 456). Which one would you like to inspect? ``` **Prompt:** ``` Show me the latest invoices for business ID 123. ``` **Response:** ``` Fetching invoices for 'Design Studio'... I found 3 recent invoices: #INV-001 (Paid, $500), #INV-002 (Sent, $1,200), and #INV-003 (Overdue, $300). ``` ## Capabilities ### Business Oversight List every business unit associated with your main Wave account. ### Billing History Retrieval Get summaries of invoices, check their status (paid, overdue), and review all outgoing bills. ### Contact Directory Management Quickly look up contact information for both customers and suppliers. ### General Ledger Analysis Review your full chart of accounts and monitor current balances across different financial categories. ### Transaction Logging List detailed accounting transactions and track recent cash flow movements for any business unit. ## Use Cases ### Quarterly Audit Prep The analyst needs to audit Q2 cash flow across three subsidiaries. They ask the agent, which chains calls using `list_businesses`, then runs `list_transactions` for each unit, providing a single comparative report. ### Overdue Accounts Check The owner needs to know which invoices are past due. They ask the agent and it executes `list_invoices`, returning only the records marked 'Overdue' for immediate follow-up. ### Vendor Payment Review A bookkeeper needs to pay a vendor but first must confirm their details. They use `list_vendors` and then cross-reference that data against recent payments using `list_bills`. ### Product Line Audit The business owner wants to see if they are tracking taxes correctly for a new service line. They ask the agent, which calls `list_products` and then uses `list_sales_taxes` to validate compliance. ## Benefits - Stop guessing on cash flow. By using `list_transactions` and `list_accounts`, you get a full, immediate picture of what money came in and where it went. - No more manual invoice checks. Asking the agent to use `list_invoices` gives you instant summaries, showing who owes money and when it's due. - Manage contacts faster than ever. Use `list_customers` or `list_vendors` to pull up contact details without leaving your current workflow. - Tackle multi-entity reporting easily. The `list_businesses` tool lets you check statuses across several company units in one go. - Always know the tax rules. You can retrieve necessary rates using `list_sales_taxes` before writing any financial report. ## How It Works The bottom line is that you manage complex financial reporting using natural conversation instead of logging into a web portal. 1. Subscribe to this MCP and enter your Wave Personal Access Token, which you generate in the Wave Developer Portal. 2. Connect your preferred AI client (like Claude or Cursor). The agent establishes a secure connection through Vinkius's zero-trust proxy. 3. Tell your agent what data you need—for example, 'Show me all overdue invoices for my E-commerce Shop.' The MCP runs the necessary calls and provides the structured answer. ## Frequently Asked Questions **How do I check if a customer exists using list_customers?** Yes, simply ask your agent to use `list_customers`. It searches the database for contact information and confirms whether or not that business has recorded users. **Can I find out what my current tax rates are with list_sales_taxes?** Absolutely. Asking the agent to use `list_sales_taxes` pulls the active tax configurations for your entire business, which is critical for compliance checks. **What's the difference between list_bills and list_transactions?** `list_bills` focuses specifically on accounts payable—the money you owe. `list_transactions` gives a broader history of all cash movements, including payments received or sent. **Does get_user_info tell me my company name?** It retrieves the basic authenticated user information linked to your account, confirming who is running the query and what details are attached to that login session. **When I run get_user_info, does that tell me which businesses are available for me to use with other tools?** Yes, it provides the initial scope of your connection. While get_user_info confirms authentication, you must still call list_businesses afterward to pull the full list and IDs needed for all other financial queries. **If I want invoices from multiple companies, do I need to run list_businesses first before using list_invoices?** You should always start with list_businesses. This call retrieves the necessary identifiers; you then pass those specific IDs into list_invoices for accurate data retrieval across different entities. **Does running list_products give me visibility into what items were included in past accounting transactions?** No, list_products only pulls a catalog of available goods and services. To see which products were actually sold or billed previously, you must use the list_invoices tool. **If I run list_transactions and the data is very large, are there any limits or pagination rules I need to know about?** The MCP handles standard API pagination. When calling list_transactions, you'll receive a cursor or next page token in the response body that tells your agent how to pull the remaining records.