# Metronome MCP for AI Agents AI Agent Connect > Metronome MCP for AI Agents. Automate your usage-based billing and revenue operations by letting your AI agent handle event ingestion, customer contracts, and invoice management. Instead of jumping between dashboards, you can query usage data, create products, and manage billing configurations through a simple chat interface. It connects your Metronome account to any MCP-compatible client so you can manage your revenue stack in one place. ## Overview - **Category:** data-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_3Vjm57CmtHrNE8DFFTtdfvwTj3HNOfDtXZMVMein/ai-agent-connect - **Tags:** usage-based-billing, revenue-operations, metering, contract-management, event-ingestion, saas-metrics ## Description Managing usage-based billing usually means drowning in spreadsheets or clicking through dozens of tabs to find out why a customer's bill spiked. This Connector changes that by giving your AI agent direct access to your Metronome account. You can now ask your agent to pull specific usage metrics or check a customer's current net balance without ever leaving your workspace. It handles the heavy lifting of revenue operations, from creating new contracts and rate cards to voiding old invoices. Whether you're trying to reconcile data for the finance team or checking if an event is actually being ingested correctly, you can just tell your agent what to do. Because Vinkius hosts this Connector, you get a clean way to plug your billing data into your existing AI workflow. It turns a complex manual process into a conversation where you just ask for the numbers and get the results. ## Tools ### create_billable_metric Create a new metric that can be billed to customers. This helps you define how you charge for specific features. ### create_commit Create a specific commit within a contract. Use this to track individual milestones or changes in a customer agreement. ### create_contract Set up a new customer contract with specific terms. It makes it easy to get new clients started with the right billing rules. ### create_customer Add a new customer to your Metronome account. This helps you onboard new clients quickly without leaving your AI client. ### create_notification Set up an offset lifecycle event notification. Use this to get alerted when specific billing milestones are reached. ### create_product Define a new product like a subscription or usage-based item. This helps you build out your catalog of offerings. ### create_rate_card Establish base prices for your products. Use this to set the foundational costs for your different service tiers. ### edit_contract Modify the terms of an existing customer contract. It lets you update agreements quickly as your business needs change. ### get_audit_logs View the history of actions taken within the account. This is great for checking who changed a balance or added a customer. ### get_customer Pull details for a specific customer profile. Use this to see all the relevant info for a client in one place. ### get_invoice Retrieve a specific invoice for a customer. This helps you quickly check the details of a past or current bill. ### get_net_balance Check the current net balance for a specific customer. It gives you an immediate look at what a client owes without opening a dashboard. ### get_services List the services currently active in the account. Use this to see what your customers have access to right now. ### get_usage_groups Fetch usage data organized into paginated groups. This helps you look at large amounts of data without getting overwhelmed. ### get_usage Retrieve batched usage data for specific metrics. Use this to see exactly how much of a service a customer has consumed. ### ingest_events Send high-volume usage events into the Metronome system. This allows you to feed raw data into your billing engine at scale. ### list_balances See a list of all current balances. Use this to get a quick overview of what is owed across your entire customer base. ### list_billable_metrics View all metrics currently set up for billing. This helps you see exactly what you are tracking for revenue. ### list_contracts See all active customer contracts in your account. Use this to keep track of all your current customer agreements. ### list_credit_types View the different pricing units available. This helps you understand the various ways you can charge your clients. ### list_customers Get a list of all customers with optional filtering. Use this to find specific clients or see your total customer count. ### list_products See all products currently defined in your catalog. Use this to check your current list of billable offerings. ### regenerate_invoice Create a new version of an existing invoice. Use this to fix mistakes on a bill without having to start over. ### search_events Look for specific events using a transaction ID for testing. This helps you find specific data points to verify your event flow. ### set_custom_field_values Update custom fields for your customers. Use this to keep your internal notes and data organized in one place. ### void_invoice Cancel an existing invoice to remove it from the balance. This is the fastest way to undo a billing error. ### add_rate Put a new rate into an existing rate card. This helps you update your pricing tiers as your costs change. ### archive_customer Void invoices and archive contracts for a customer. Use this to clean up your records when a client leaves. ### create_alert Set up a threshold notification for billing alerts. This helps you get notified before a customer hits a usage limit. ### list_invoices Pull a list of all customer invoices. This helps you manage your billing cycle and see what has been sent out. ### add_custom_field_key Create a new custom field key for customer data. Use this to expand what kind of custom info you can store. ## Prompt Examples **Prompt:** ``` Show me the current net balance for customer cust_992 and tell me if they have any outstanding invoices. ``` **Response:** ``` Checking the balance for customer **cust_992**... | Customer | Net Balance | Status | | :--- | :--- | :--- | | cust_992 | $4,250.00 | Finalized | I also found one outstanding invoice (**inv_556677**) for $4,250.00. Would you like me to list the line items for this bill? ``` **Prompt:** ``` I need to create a new contract for a new client. Can you list the available credit types and then set up a new customer? ``` **Response:** ``` Here are the available credit types: * **Standard**: 30-day net * **Enterprise**: 60-day net * **Custom**: Negotiated terms I'm ready to create the new customer. Please provide the customer name and the credit type you'd like to use! ``` **Prompt:** ``` Can you check the audit logs for any changes made to customer contracts in the last 24 hours? ``` **Response:** ``` I've retrieved the audit logs from the last 24 hours. Here are the recent contract changes: * **Contract_442**: Edited by admin_user at 14:22 UTC * **Contract_881**: Created by sales_lead at 09:15 UTC * **Contract_210**: Archived by finance_ops at 11:05 UTC ``` ## Capabilities ### Pull customer usage data Your agent can fetch batched usage metrics or paginated groups for any customer. ### Manage billing contracts Create, edit, or list customer contracts and rate cards through a chat interface. ### Handle invoices View, void, or regenerate customer invoices and check net balances instantly. ### Ingest usage events Send high-volume usage events into your billing engine from your AI client. ### Set up billing alerts Create threshold notifications and alerts to monitor your revenue metrics. ### Audit billing actions Access audit logs to see a history of changes made to your account. ## Use Cases ### Fixing a customer overcharge A customer claims they were overcharged. The finance lead asks the agent to get_invoice and void_invoice to fix it immediately. ### New customer onboarding A salesperson signs a new deal. They tell the agent to create_customer, create_contract, and create_rate_card to get them live. ### Usage audit and troubleshooting An engineer notices a spike in costs. They ask the agent to get_usage and search_events to find the specific transaction ID causing the issue. ### Automated billing alerts A product manager wants to know if a customer hits a limit. They ask the agent to create_alert and create_notification for high-usage thresholds. ## Benefits - Get instant answers on customer balances by using get_net_balance to skip manual dashboard navigation. - Handle complex invoice adjustments faster by using void_invoice and regenerate_invoice directly in chat. - Simplify contract management by using create_contract and edit_contract to update terms without a UI. - Monitor billing health more closely by using get_audit_logs to see exactly who changed what. - Manage your entire product catalog easily with list_products and create_rate_card to keep pricing consistent. - Reduce manual data entry by using create_customer and add_custom_field_key to build your database via chat. ## How It Works The bottom line is you get a conversational interface for your entire revenue operations stack. 1. Subscribe to the Metronome MCP on Vinkius 2. Enter your Metronome API Token in your AI client 3. Ask your agent to manage customers, invoices, or contracts ## Frequently Asked Questions **Can the Metronome MCP help me manage my SaaS billing?** Yes, it lets you handle everything from customer contracts to invoice management through your AI client. **Can I use Metronome MCP to fix a customer's incorrect invoice?** You can use the agent to void an invoice or regenerate a new one without leaving your chat. **How does Metronome MCP handle usage data?** Your agent can pull batched usage data or group it into paginated lists so you can see exactly what customers are using. **Can I set up automated alerts with Metronome MCP?** Yes, you can ask your agent to create threshold notifications and alerts to monitor your billing metrics. **Can I manage my product catalog using Metronome MCP?** You can list all products, create new ones, and set up rate cards for your different pricing tiers. **Is Metronome MCP good for auditing my billing actions?** It allows you to pull audit logs so you can see a history of actions taken in your account. **Can I check the current net balance for a specific customer?** Yes! Use the `get_net_balance` tool with the specific `customer_id` to retrieve the real-time balance information. **How do I see usage broken down by specific dimensions?** You can use the `get_usage_groups` tool. It allows you to retrieve granular usage data for a specific customer and metric, broken down by your custom grouping dimensions. **Is it possible to list all invoices for a client to check their payment history?** Absolutely. Use the `list_invoices` tool and provide the `customer_id` to see a paginated list of all invoices associated with that account.