Lago MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.5Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for Lago billing: read customers, subscriptions, invoices, usage and revenue analytics, and log usage events.

What you can do
  • List and retrieve customers, their subscriptions, current and past usage, and billing portal links
  • List and retrieve subscriptions, plans, billable metrics, coupons, add-ons, wallets and fees
  • List and retrieve invoices and credit notes, filtered by customer, status or date
  • Report monthly recurring revenue and gross revenue analytics
  • Create customers and record usage/metering events that count toward billing
  • Check the monthly call quota, request features, and upgrade or cancel the paid plan
When to use it
Useful when you want to ask questions about Lago billing in natural language — revenue trends, unpaid invoices, a customer's current usage — or log metering events without opening the Lago dashboard.
Requirements
Remote streamable HTTP endpoint; no local install. Connect with the server URL only and sign in through OAuth, then paste a Lago API key on first connect, which is validated and stored per user. A free plan allows 50 tool calls per month; paid plans are available.
Before you install
The server asks for your Lago API key, which it stores per user on a third-party host. Two tools write data: creating a customer and recording usage events, which affect billing and are only idempotent when a transaction_id is supplied. Paid plans are billed through Stripe Checkout links, and cancelling does not refund the current period. Free tier is capped at 50 calls per month.

Installation

In SourceWeft

  1. Open Lago MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Flago/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "lago-by-usefulapi": {
      "type": "http",
      "url": "https://lago.usefulapi.io/mcp"
    }
  }
}

README

Lago MCP by usefulapi

Query your Lago billing — customers, subscriptions, invoices, usage, and revenue analytics — and log usage events, from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Lago API key.

Live endpoint: https://lago.usefulapi.io/mcp · Homepage: https://usefulapi.io/lago

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://lago.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http lago https://lago.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "lago": {      "url": "https://lago.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Lago credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/lago/

On first connect you'll paste your Lago API key. It's validated, stored per-user, and scoped to you.

Tools

ToolTypeWhat it does
lago_list_customersreadList customers
lago_get_customerreadGet customer
lago_get_customer_current_usagereadGet customer current usage
lago_get_customer_past_usagereadGet customer past usage
lago_list_customer_subscriptionsreadList customer subscriptions
lago_get_customer_portal_urlreadGet customer portal URL
lago_list_subscriptionsreadList subscriptions
lago_get_subscriptionreadGet subscription
lago_list_plansreadList plans
lago_get_planreadGet plan
lago_list_invoicesreadList invoices
lago_get_invoicereadGet invoice
lago_list_billable_metricsreadList billable metrics
lago_get_billable_metricreadGet billable metric
lago_list_couponsreadList coupons
lago_list_add_onsreadList add-ons
lago_list_walletsreadList wallets
lago_list_credit_notesreadList credit notes
lago_get_credit_notereadGet credit note
lago_list_feesreadList fees
lago_analytics_gross_revenuereadAnalytics: gross revenue
lago_analytics_mrrreadAnalytics: MRR
lago_create_customerwriteCreate customer
lago_create_eventwriteCreate usage event
lago_usage_statusmetaUsage status (free-tier meter)
lago_request_featuremetaRequest a missing feature
lago_upgrademetaUpgrade to Pro or Pro+
lago_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with lago_upgrade (it returns a Stripe Checkout link). Cancel any time with lago_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running lago_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/lago/README.md at commit 4046075

Tools

24

lago_list_customers

List customers

List customers in Lago, paginated. Lago API: GET /customers.

Parameterspageper_page

lago_get_customer

Get customer

Retrieve a single customer by external id. Lago API: GET /customers/{external_customer_id}.

Parametersexternal_customer_idrequired

lago_get_customer_current_usage

Get customer current usage

Retrieve a customer's usage-based billing data for the current period. Lago API: GET /customers/{external_customer_id}/current_usage.

Parametersapply_taxesexternal_customer_idrequiredexternal_subscription_idrequired

lago_get_customer_past_usage

Get customer past usage

Retrieve a customer's usage-based billing data for past periods. Lago API: GET /customers/{external_customer_id}/past_usage.

Parametersperiods_countbillable_metric_codeexternal_customer_idrequiredexternal_subscription_idrequired

lago_list_customer_subscriptions

List customer subscriptions

List a customer's subscriptions. Lago API: GET /customers/{external_customer_id}/subscriptions.

Parametersexternal_customer_idrequired

lago_get_customer_portal_url

Get customer portal URL

Get a customer's billing portal URL. Lago API: GET /customers/{external_customer_id}/portal_url.

Parametersexternal_customer_idrequired

lago_list_subscriptions

List subscriptions

List subscriptions, optionally filtered by customer, plan, or status. Lago API: GET /subscriptions.

Parameterspagestatusper_pageplan_codeexternal_customer_id

lago_get_subscription

Get subscription

Retrieve a single subscription by external id. Lago API: GET /subscriptions/{external_id}.

Parametersexternal_idrequired

lago_list_plans

List plans

List billing plans, paginated. Lago API: GET /plans.

Parameterspageper_page

lago_get_plan

Get plan

Retrieve a single plan by code. Lago API: GET /plans/{code}.

Parameterscoderequired

lago_list_invoices

List invoices

List invoices, optionally filtered by customer, status, payment status, or issuing date. Lago API: GET /invoices.

Parameterspagestatusper_pagepayment_statusissuing_date_toissuing_date_fromexternal_customer_id

lago_get_invoice

Get invoice

Retrieve a single invoice by its Lago id. Lago API: GET /invoices/{lago_id}.

Parameterslago_idrequired

lago_list_billable_metrics

List billable metrics

List billable metrics, paginated. Lago API: GET /billable_metrics.

Parameterspageper_page

lago_get_billable_metric

Get billable metric

Retrieve a single billable metric by code. Lago API: GET /billable_metrics/{code}.

Parameterscoderequired

lago_list_coupons

List coupons

List coupons, paginated. Lago API: GET /coupons.

Parameterspageper_page

lago_list_add_ons

List add-ons

List add-ons, paginated. Lago API: GET /add_ons.

Parameterspageper_page

lago_list_wallets

List wallets

List a customer's prepaid credit wallets. Lago API: GET /customers/{external_customer_id}/wallets.

Parameterspageper_pageexternal_customer_idrequired

lago_list_credit_notes

List credit notes

List credit notes, optionally filtered by customer. Lago API: GET /credit_notes.

Parameterspageper_pageexternal_customer_id

lago_get_credit_note

Get credit note

Retrieve a single credit note by its Lago id. Lago API: GET /credit_notes/{lago_id}.

Parameterslago_idrequired

lago_list_fees

List fees

List fees, optionally filtered by customer, subscription, or fee type. Lago API: GET /fees.

Parameterspagefee_typeper_pageexternal_customer_idexternal_subscription_id

lago_analytics_gross_revenue

Analytics: gross revenue

Monthly gross revenue (finalized invoice payments + advance fees, net of tax/discounts). Lago API: GET /analytics/gross_revenue.

Parametersmonthscurrencyexternal_customer_id

lago_analytics_mrr

Analytics: MRR

Monthly recurring revenue (MRR) from subscription fees. Lago API: GET /analytics/mrr.

Parametersmonthscurrency

lago_create_customer

Create customer

Creates a customer in Lago (additive). Lago API: POST /customers with body { "customer": { ... } }.

Parametersurlnameemailphonecountrycurrencymetadatatimezonelegal_nameexternal_idrequiredlegal_numbertax_identification_number

lago_create_event

Create usage event

Records a usage/metering event in Lago. This WILL be counted toward the customer's usage and affects billing. Idempotent via transaction_id. Lago API: POST /events with body { "event": { ... } }.

Parameterscoderequiredtimestamppropertiestransaction_idrequiredexternal_subscription_idrequiredprecise_total_amount_cents

Version history

22
  1. v1.36.5LatestNov 8, 2026
  2. v1.36.4Nov 7, 2026
  3. v1.35.3Nov 5, 2026
  4. v1.35.2Nov 5, 2026
  5. v1.35.1Nov 4, 2026
  6. v1.35.0Nov 3, 2026
  7. v1.34.1Nov 3, 2026
  8. v1.33.0Nov 1, 2026
  9. v1.31.0Oct 31, 2026
  10. v1.30.0Oct 31, 2026
  11. v1.29.2Oct 30, 2026
  12. v1.29.0Oct 30, 2026
  13. v1.24.0Oct 26, 2026
  14. v1.21.3Oct 25, 2026
  15. v1.21.0Oct 25, 2026
  16. v1.20.0Oct 24, 2026
  17. v1.17.0Oct 23, 2026
  18. v1.16.4Oct 22, 2026
  19. v1.16.3Oct 21, 2026
  20. v1.11.1Oct 9, 2026
  21. v1.10.0Oct 9, 2026
  22. v1.0.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 8, 2026

Tiltify MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant read Tiltify campaigns, donations and top donor and fundraiser leaderboards.

Streamable HTTPWeb executable
Finance5 toolsNov 8, 2026

Termii MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Termii server that lets an assistant send SMS, check wallet balance, DND status, sender IDs and message history.

Streamable HTTPWeb executable
Communication & Collaboration5 toolsNov 8, 2026

Temp Stick MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server that lets an assistant read Temp Stick temperature and humidity sensors, their readings and alert notifications.

Streamable HTTPWeb executable
Location & Lifestyle4 toolsNov 8, 2026

Stibee MCP by usefulapi

io.usefulapiOfficial publisher

Connects an assistant to a Stibee email marketing workspace to read address books, subscribers and email stats, and to add subscribers and group members.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 8, 2026