usefulapi

Lago MCP server. Read Lago customers, subscriptions, invoices, usage and revenue analytics; write events.

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://lago.usefulapi.io/mcp
Authenticate with Lago when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "lago": {
      "url": "https://lago.usefulapi.io/mcp"
    }
  }
}

live26 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 26

Tool	Type	What it does
`lago_list_customers`	read	List customers List all customers in your Lago account with pagination, returning each customer's external id, name, email, currency, and billing configuration.
`lago_get_customer`	read	Get customer Retrieve a single customer by external id, including their billing details, addresses, tax settings, currency, and metadata.
`lago_get_customer_current_usage`	read	Get customer current usage Fetch a customer's usage-based billing data for the in-progress billing period on a given subscription, broken down by billable metric and charge.
`lago_get_customer_past_usage`	read	Get customer past usage Retrieve a customer's usage-based billing data for prior billing periods, optionally scoped to a specific billable metric, for trend and reconciliation analysis.
`lago_list_customer_subscriptions`	read	List customer subscriptions List all subscriptions belonging to a specific customer, showing the plan, status, and billing dates for each one.
`lago_get_customer_portal_url`	read	Get customer portal url Generate a customer's self-service billing portal URL where they can view invoices and manage their payment methods.
`lago_list_subscriptions`	read	List subscriptions List subscriptions across the account with pagination, filterable by customer, plan code, or status (active, pending, canceled, terminated).
`lago_get_subscription`	read	Get subscription Retrieve a single subscription by its external id, including the plan, current status, billing time, and lifecycle dates.
`lago_list_plans`	read	List plans List all billing plans with pagination, returning each plan's code, billing interval, pricing model, and charges.
`lago_get_plan`	read	Get plan Retrieve a single billing plan by its code, including its charges, minimum commitments, and full pricing configuration.
`lago_list_invoices`	read	List invoices List invoices with pagination, filterable by customer, invoice status, payment status, and issuing-date range.
`lago_get_invoice`	read	Get invoice Retrieve a single invoice by its Lago id, including line items, fees, taxes, totals, and payment status.
`lago_list_billable_metrics`	read	List billable metrics List all billable metrics with pagination, showing each metric's code, aggregation type, and field configuration.
`lago_get_billable_metric`	read	Get billable metric Retrieve a single billable metric by its code, including its aggregation type, filters, and rounding rules.
`lago_list_coupons`	read	List coupons List all discount coupons with pagination, returning each coupon's code, type, amount or percentage, and expiration.
`lago_list_add_ons`	read	List add ons List all one-off add-ons with pagination, showing each add-on's code, name, and default amount.
`lago_list_wallets`	read	List wallets List a customer's prepaid credit wallets, returning each wallet's balance, remaining credits, and status.
`lago_list_credit_notes`	read	List credit notes List credit notes with pagination, optionally filtered by customer, showing refunded and credited amounts per note.
`lago_get_credit_note`	read	Get credit note Retrieve a single credit note by its Lago id, including its items, reason, and full refund and credit breakdown.
`lago_list_fees`	read	List fees List individual fees with pagination, filterable by customer, subscription, or fee type (charge, add-on, subscription, credit, commitment).
`lago_analytics_gross_revenue`	read	Analytics gross revenue Return monthly gross revenue — finalized invoice payments and advance fees net of tax and discounts — optionally scoped by currency or customer.
`lago_analytics_mrr`	read	Analytics mrr Return monthly recurring revenue (MRR) computed from subscription fees, optionally filtered by currency, for growth tracking.
`lago_create_customer`	write	Create customer Create a new customer in Lago from an external id, with optional name, email, currency, timezone, tax details, and metadata.
`lago_create_event`	write	Create event Record a usage/metering event against a subscription's billable metric — idempotent via transaction_id — which counts toward the customer's usage and billing.
`lago_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
`lago_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Lago tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.