Lago MCP Server for Mastra AIGive Mastra AI instant access to 12 tools to Apply Coupon, Batch Events, Create Billable Metric, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Lago through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Lago MCP Server for Mastra AI is a standout in the Money Moves category — giving your AI agent 12 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"lago": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Lago Agent",
instructions:
"You help users interact with Lago " +
"using 12 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Lago?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Lago MCP Server
Connect Lago to your AI agent to automate your metering and billing infrastructure. Lago is the open-source alternative to Stripe Billing, designed for complex usage-based pricing models.
Mastra's agent abstraction provides a clean separation between LLM logic and Lago tool infrastructure. Connect 12 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Customer Management — Create and update customer profiles with
upsert_customerand retrieve details withget_customer. - Subscription Lifecycle — Assign plans to customers using
create_subscriptionand monitor them withget_subscription. - Billing Infrastructure — Define billing plans with
create_planand set upcreate_billable_metricto track consumption. - Usage Tracking — Send real-time usage data with
send_eventorbatch_eventsto trigger accurate billing. - Financial Operations — Manage wallets, apply coupons, and list invoices to keep your revenue operations running smoothly.
The Lago MCP Server exposes 12 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 12 Lago tools available for Mastra AI
When Mastra AI connects to Lago through Vinkius, your AI agent gets direct access to every tool listed below — spanning usage-based-billing, metering, saas-metrics, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Apply coupon on Lago
Apply a coupon to a customer
Batch events on Lago
Send a batch of usage events
Create billable metric on Lago
Create a billable metric
Create coupon on Lago
Create a coupon
Create plan on Lago
Create a new billing plan
Create subscription on Lago
Assign a plan to a customer (create subscription)
Create wallet on Lago
Create a wallet for prepaid credits
Get customer on Lago
Retrieve a customer by external ID
Get subscription on Lago
Retrieve a subscription by external ID
List invoices on Lago
List all invoices
Send event on Lago
Send a usage event
Upsert customer on Lago
Requires an external_id. Create or update a customer in Lago
Connect Lago to Mastra AI via MCP
Follow these steps to wire Lago into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Lago MCP Server
Mastra AI provides unique advantages when paired with Lago through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Lago without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Lago tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Lago + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Lago MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Lago, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Lago as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Lago on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Lago tools alongside other MCP servers
Example Prompts for Lago in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Lago immediately.
"Create a new customer in Lago with external ID 'user_123' and email 'dev@example.com'."
"Show me the subscription details for ID 'sub_98765'."
"List all invoices for my Lago account."
Troubleshooting Lago MCP Server with Mastra AI
Common issues when connecting Lago to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpLago + Mastra AI FAQ
Common questions about integrating Lago MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
NOAA Observations — US Current Conditions
5 toolsReal-time weather observations from thousands of official NWS stations: temperature, wind speed and direction, humidity, barometric pressure, visibility, and weather conditions across the United States.

CVM Dados Abertos
6 toolsAccess Brazilian capital markets data directly from the CVM Open Data portal — query investment funds, listed companies, and financial reports.

OSTI (DOE Scientific Research)
6 toolsAccess Department of Energy research, datasets, and scientific publications. Search records, retrieve metadata, and manage DOI registrations.

Road511
8 toolsAccess real-time US and Canada traffic data via Road511 — track incidents, monitor cameras, check road conditions, and analyze trends from any AI agent.
