Lago MCP. Automate Complex Usage Billing Logic
Lago connects your AI agent to robust metering and usage-based billing. Handle complex pricing models—including custom plans, prepaid credits, and real-time consumption tracking—without leaving your chat interface.
Claude 
ChatGPT 
Cursor 
Gemini 
Windsurf 
VS Code 
JetBrains 
Vercel Give Claude and any AI agent real-world access
Create or update full customer records and retrieve existing details using a unique external ID.
Set up new billing plans, assign those plans to customers, or pull up the status of any active subscription.
Send single usage events or large batches of data points that automatically trigger consumption and billing updates.
Generate invoices, create coupon codes, or top up customer prepaid credit wallets.
Pull specific data points about what can be billed, ensuring your usage tracking is accurate before billing cycles end.
Ask an AI about this
Waiting for input…
What AI agents can do with Lago with 12 Tools
These tools give your agent direct access to all core functions of a modern metering and billing platform.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Lago MCPApply Coupon
Applies a specific coupon code to an existing customer's account.
Batch Events
Sends multiple usage events at once, useful for syncing historical data or large...
Create Billable Metric
Defines a new type of resource that can be measured and charged against customer...
Create Coupon
Generates a new, usable coupon code for your customers to redeem.
Create Plan
Builds and saves an entirely new billing plan structure within the system.
Create Subscription
Assigns a specific, pre-existing pricing plan to a customer account, activating their subscription.
Create Wallet
Creates a dedicated wallet balance for prepaid credits or stored value for any user.
Get Customer
Retrieves all current profile details for a customer using their unique external ID.
Get Subscription
Fetches the full status and details of any active subscription account.
List Invoices
Pulls a list of all past and pending invoices associated with your accounts.
Send Event
Sends a single, real-time usage event immediately to trigger billing updates.
Upsert Customer
Creates a new customer record or safely updates an existing one using its unique external ID.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Lago integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Lago, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Lago. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The Struggle of Billing Reconciliation
Today, tracking revenue is a painful process. You jump between your usage dashboard, your customer database, and your billing system. If you need to check what a specific client used last month, you spend time finding the right ID, cross-referencing the usage logs, then manually calculating if they hit a discount threshold. It's clicking through tabs until your eyes bleed.
With this MCP, your agent handles that whole mess in seconds. You simply ask it to 'Show me the billing details for Client X.' The process—retrieving the customer record, pulling the usage data, and calculating the final charge—happens automatically when you use `get_customer` or `list_invoices`. It’s instant context.
Automating Billing Logic with Lago
The manual steps that disappear are the data synchronization and the calculation itself. You no longer have to manually send usage counts or update customer plans across multiple interfaces; you just tell your agent what needs to happen.
What's different now is control. You maintain complete oversight of every billing action—from setting up a new `create_plan` to applying a coupon with `apply_coupon`—all through simple conversation. The system handles the complexity, and you get clear results.
What Lago MCP does for your AI
This MCP lets you automate the entire cycle of usage-based revenue operations. Forget juggling multiple dashboards or writing custom scripts every time a customer consumes resources; you manage it all through natural language. You can create new pricing plans, assign them to customers, and even set up prepaid credit wallets for immediate use.
When activity happens, you send simple usage events that trigger accurate billing calculations in real-time. Need to correct something? Your agent handles applying coupons or generating detailed invoices instantly. Connecting Lago via the Vinkius catalog makes your entire revenue stack available from one place, letting you manage everything—from customer setup to final invoice generation—directly through your preferred AI client.
019e38b5-9e2d-7046-8fd1-f950abf0b129 
How to set up Lago MCP
The bottom line is that you talk to your agent like talking to a finance analyst, and it handles all the complex API calls needed to manage billing logic.
First, subscribe to this MCP and provide your API key within your AI client.
Next, tell your agent exactly what you need—like 'Create a new plan for 100 units at $0.05' or 'Send usage data for the last hour'.
Finally, the MCP executes the billing action in Lago and provides confirmation of the change.
Who uses Lago MCP
This connector is built for Revenue Operations Managers, SaaS Founders, and Finance Analysts. If your business relies on usage-based billing (where costs change based on consumption), you'll need this. It solves the pain of manually reconciling complex usage logs across different systems.
Needs to quickly check a customer's subscription status or adjust their plan via natural conversation without logging into a separate billing dashboard.
Automates the creation of promotional coupons, managing credit wallets, and ensuring usage events are logged correctly for immediate billing purposes.
Retrieves historical invoices or verifies billable metrics for quarterly reporting by simply asking the AI agent.
Benefits of connecting Lago MCP
Stop manual billing calculations. You can send usage data via the send_event or batch_events tools, making sure your customers are billed instantly and accurately based on real-time consumption.
Manage customer finances without leaving chat. Use create_wallet to issue prepaid credits and apply_coupon to run promotions instantly, all through natural language queries.
Build complex pricing models easily. The create_plan tool lets you define new tiers (e.g., 'Tier 2: $0.10/unit') that your customers can subscribe to using create_subscription.
Maintain clean data integrity. Use upsert_customer and get_customer together to ensure every customer profile is accurate before running any billing operations.
Simplify reporting. Your agent handles listing all invoices via list_invoices, giving you immediate visibility into outstanding revenue without needing a dashboard view.
Lago MCP use cases
A new feature was released and needs immediate metering.
The growth engineer knows the service is going live. They ask their agent to 'Create a billable metric called API_CALLS' using create_billable_metric. This ensures that when users start making calls, those specific actions are immediately accounted for in billing.
A large corporate client needs an immediate discount.
The sales rep asks the agent to 'Apply a 25% coupon to Acme Corp'. The agent uses apply_coupon and confirms the discount, ensuring the revenue team can process the change instantly.
End-of-quarter billing reconciliation is due.
The finance analyst simply asks the agent to 'List all invoices for Q2'. The agent runs list_invoices and provides a summarized view, eliminating hours of spreadsheet work.
A beta user needs immediate access but has no paid plan.
The product manager asks the agent to 'Create a $50 credit wallet for Beta User 789'. The agent uses create_wallet, giving the user instant, pre-paid access while the billing team finalizes their subscription.
Lago MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Manual Usage Logging
Copying usage counts from a separate metrics dashboard into a spreadsheet and manually calculating charges. This is slow, prone to errors, and misses real-time events.
Instead of logging data manually, use the batch_events tool. You send all historical or accumulated usage data in one go, letting Lago calculate and record it automatically.
Ignoring Customer Updates
When a customer changes emails or names, you have to find their profile ID first, then manually update the details in a separate system. This often leads to orphaned records.
Use upsert_customer. You give your agent the external ID and the new data; the tool either updates the existing record or creates it if it's brand new.
Hardcoding Pricing Changes
If you need to change a pricing tier from $0.10/unit to $0.09/unit, you have to contact an engineer and deploy code changes just for that one rule.
Use the create_plan tool through your agent. You define the new billing parameters naturally in conversation, and the system updates the pricing logic immediately.
When to use Lago MCP
You need this MCP if your business charges customers based on variable usage (like API calls, stored data volume, or transactions) and requires complex financial rules (discounts, credits). You must use it because standard payment gateways only handle simple transaction processing, not the underlying metering logic. Don't use Lago if all you do is charge a flat $9.99 per month; for that, a simpler subscription service might suffice. However, if your pricing structure includes coupons (apply_coupon), credit wallets (create_wallet), or usage-based tiers, this MCP handles the entire financial lifecycle from one place.
Frequently asked questions about Lago MCP
How do I handle usage-based billing with Lago? +
You use the send_event or batch_events tools to push real-time consumption data. This triggers the metering system, which accurately tracks and bills against defined metrics.
Can I change a customer's plan using Lago? +
Yes, you can assign new billing plans by running create_subscription. You just need to know the target plan ID beforehand.
What is the difference between `upsert_customer` and creating a customer? +
Upsert_customer is for updating records. It's safer because it tries to update an existing client first; if that fails, it creates them instead.
Does Lago handle prepaid credits? +
Yes. You can set up and manage prepaid funds by using the create_wallet tool to issue stored value or credit to a customer account.
How do I verify if I've created a metric correctly with Lago? +
You should use the get_customer tool first, then follow up by calling create_billable_metric. This lets you confirm the resource is ready to track usage.