Lago MCP by usefulapi
Server Details
Read Lago customers, subscriptions, invoices, usage and revenue analytics; write events.
- Status
- Healthy
- Uptime
- 80.4% over 57 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- m190/usefulapi-mcp
- GitHub Stars
- 0
TDQS
Scored across 24 tools
Each tool targets a distinct entity and action (e.g., lago_get_customer vs. lago_create_customer, lago_list_invoices vs. lago_get_invoice), with no overlapping purposes. The separation between analytics, customer, invoice, subscription, and other resource types is clear.
All tools follow a consistent verb_noun pattern with lower_snake_case and the 'lago_' prefix. Actions like 'get', 'list', 'create', and 'retrieve-related' (e.g., lago_get_customer_current_usage) are uniform, making the naming predictable.
With 24 tools, the server covers a broad range of billing/analytics operations. While slightly high, each tool serves a distinct purpose for reading or creating core entities and analytics. The count is well-scoped for its domain.
The server overwhelmingly focuses on read operations (list/get) with only two write tools (create_customer, create_event). Missing CRUD for invoices, subscriptions, plans, add-ons, coupons, credit notes, and wallets limits agents to mostly read-only workflows, creating significant gaps for managing billing lifecycles.
Available Tools
24 toolslago_analytics_gross_revenueAnalytics: gross revenueRead-onlyInspect
Monthly gross revenue (finalized invoice payments + advance fees, net of tax/discounts). Lago API: GET /analytics/gross_revenue.
| Name | Required | Description | Default |
|---|---|---|---|
| months | No | Number of months to return. | |
| currency | No | Currency filter (ISO 4217, e.g. USD). | |
| external_customer_id | No | Filter revenue at the customer level. |
lago_analytics_mrrAnalytics: MRRRead-onlyInspect
Monthly recurring revenue (MRR) from subscription fees. Lago API: GET /analytics/mrr.
| Name | Required | Description | Default |
|---|---|---|---|
| months | No | Number of months to return. | |
| currency | No | Currency filter (ISO 4217, e.g. USD). |
lago_create_customerCreate customerDestructiveInspect
Creates a customer in Lago (additive). Lago API: POST /customers with body { "customer": { ... } }.
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Customer URL. | |
| name | No | Full name of the customer. | |
| No | Email of the customer. | ||
| phone | No | Phone number. | |
| country | No | Billing country code (ISO 3166 alpha-2). | |
| currency | No | Customer currency (ISO 4217). | |
| metadata | No | Structured metadata to attach to the customer (Lago expects an array of {key, value, display_in_invoice?} objects). | |
| timezone | No | Customer timezone, e.g. America/New_York. | |
| legal_name | No | Legal company name. | |
| external_id | Yes | The customer external unique identifier (required, provided by your application). | |
| legal_number | No | Legal company number. | |
| tax_identification_number | No | Tax identification number. |
lago_create_eventCreate usage eventDestructiveInspect
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": { ... } }.
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | The billable metric code this event targets (required). | |
| timestamp | No | Unix timestamp in seconds (or ISO); defaults to event reception time. | |
| properties | No | Additional event properties used to compute the fee (required for sum/max/unique aggregations). | |
| transaction_id | Yes | Unique identifier for the event — the idempotency key (required). | |
| external_subscription_id | Yes | The subscription external id to link the event to (required). | |
| precise_total_amount_cents | No | Precise total amount in cents, used by the dynamic pricing model. |
lago_get_billable_metricGet billable metricRead-onlyInspect
Retrieve a single billable metric by code. Lago API: GET /billable_metrics/{code}.
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | The billable metric's unique code. |
lago_get_credit_noteGet credit noteRead-onlyInspect
Retrieve a single credit note by its Lago id. Lago API: GET /credit_notes/{lago_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| lago_id | Yes | The credit note's Lago id (UUID). |
lago_get_customerGet customerRead-onlyInspect
Retrieve a single customer by external id. Lago API: GET /customers/{external_customer_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| external_customer_id | Yes | The customer external unique identifier (from your application). |
lago_get_customer_current_usageGet customer current usageRead-onlyInspect
Retrieve a customer's usage-based billing data for the current period. Lago API: GET /customers/{external_customer_id}/current_usage.
| Name | Required | Description | Default |
|---|---|---|---|
| apply_taxes | No | Whether taxes should be applied. Defaults to true. | |
| external_customer_id | Yes | The customer external unique identifier. | |
| external_subscription_id | Yes | The subscription's external unique identifier (required). |
lago_get_customer_past_usageGet customer past usageRead-onlyInspect
Retrieve a customer's usage-based billing data for past periods. Lago API: GET /customers/{external_customer_id}/past_usage.
| Name | Required | Description | Default |
|---|---|---|---|
| periods_count | No | Number of past billing periods to return. | |
| billable_metric_code | No | Filter usage to a specific billable metric code. | |
| external_customer_id | Yes | The customer external unique identifier. | |
| external_subscription_id | Yes | The subscription's external unique identifier (required). |
lago_get_customer_portal_urlGet customer portal URLRead-onlyInspect
Get a customer's billing portal URL. Lago API: GET /customers/{external_customer_id}/portal_url.
| Name | Required | Description | Default |
|---|---|---|---|
| external_customer_id | Yes | The customer external unique identifier. |
lago_get_invoiceGet invoiceRead-onlyInspect
Retrieve a single invoice by its Lago id. Lago API: GET /invoices/{lago_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| lago_id | Yes | The invoice's Lago id (UUID). |
lago_get_planGet planRead-onlyInspect
Retrieve a single plan by code. Lago API: GET /plans/{code}.
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | The plan's unique code. |
lago_get_subscriptionGet subscriptionRead-onlyInspect
Retrieve a single subscription by external id. Lago API: GET /subscriptions/{external_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| external_id | Yes | The subscription's external unique identifier. |
lago_list_add_onsList add-onsRead-onlyInspect
List add-ons, paginated. Lago API: GET /add_ons.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| per_page | No | Number of records per page. |
lago_list_billable_metricsList billable metricsRead-onlyInspect
List billable metrics, paginated. Lago API: GET /billable_metrics.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| per_page | No | Number of records per page. |
lago_list_couponsList couponsRead-onlyInspect
List coupons, paginated. Lago API: GET /coupons.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| per_page | No | Number of records per page. |
lago_list_credit_notesList credit notesRead-onlyInspect
List credit notes, optionally filtered by customer. Lago API: GET /credit_notes.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| per_page | No | Number of records per page. | |
| external_customer_id | No | Filter by customer external id. |
lago_list_customersList customersRead-onlyInspect
List customers in Lago, paginated. Lago API: GET /customers.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| per_page | No | Number of records per page. |
lago_list_customer_subscriptionsList customer subscriptionsRead-onlyInspect
List a customer's subscriptions. Lago API: GET /customers/{external_customer_id}/subscriptions.
| Name | Required | Description | Default |
|---|---|---|---|
| external_customer_id | Yes | The customer external unique identifier. |
lago_list_feesList feesRead-onlyInspect
List fees, optionally filtered by customer, subscription, or fee type. Lago API: GET /fees.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| fee_type | No | Filter by fee type: charge | add_on | subscription | credit | commitment. | |
| per_page | No | Number of records per page. | |
| external_customer_id | No | Filter by customer external id. | |
| external_subscription_id | No | Filter by subscription external id. |
lago_list_invoicesList invoicesRead-onlyInspect
List invoices, optionally filtered by customer, status, payment status, or issuing date. Lago API: GET /invoices.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| status | No | Filter by a single status: draft | finalized | failed | pending | voided. | |
| per_page | No | Number of records per page. | |
| payment_status | No | Filter by a single payment status: pending | failed | succeeded. | |
| issuing_date_to | No | Filter invoices issued on/before this date (yyyy-mm-dd). | |
| issuing_date_from | No | Filter invoices issued on/after this date (yyyy-mm-dd). | |
| external_customer_id | No | Filter by customer external id. |
lago_list_plansList plansRead-onlyInspect
List billing plans, paginated. Lago API: GET /plans.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| per_page | No | Number of records per page. |
lago_list_subscriptionsList subscriptionsRead-onlyInspect
List subscriptions, optionally filtered by customer, plan, or status. Lago API: GET /subscriptions.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| status | No | Filter by a single status: active | pending | canceled | terminated. Default active. | |
| per_page | No | Number of records per page. | |
| plan_code | No | Filter by plan code. | |
| external_customer_id | No | Filter by customer external id. |
lago_list_walletsList walletsRead-onlyInspect
List a customer's prepaid credit wallets. Lago API: GET /customers/{external_customer_id}/wallets.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| per_page | No | Number of records per page. | |
| external_customer_id | Yes | The customer external unique identifier. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
24 tool updates
- Changed
lago_analytics_gross_revenue1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_analytics_mrr1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_create_customer1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_create_event5 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / properties / properties / additionalProperties / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "number" - } -] - added
Input schema / properties / properties / additionalProperties / typeAdded value: +[ + "string", + "number" +] - removed
Input schema / properties / timestamp / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "number" - } -] - added
Input schema / properties / timestamp / typeAdded value: +[ + "string", + "number" +]
- Changed
lago_get_billable_metric1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_get_credit_note1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_get_customer1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_get_customer_current_usage1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_get_customer_past_usage1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_get_customer_portal_url1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_get_invoice1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_get_plan1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_get_subscription1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_add_ons1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_billable_metrics1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_coupons1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_credit_notes1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_customer_subscriptions1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_customers1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_fees1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_invoices1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_plans1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_subscriptions1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
- Changed
lago_list_wallets1 field changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
24 tool updates
- First observed
lago_analytics_gross_revenue - First observed
lago_analytics_mrr - First observed
lago_create_customer - First observed
lago_create_event - First observed
lago_get_billable_metric - First observed
lago_get_credit_note - First observed
lago_get_customer - First observed
lago_get_customer_current_usage - First observed
lago_get_customer_past_usage - First observed
lago_get_customer_portal_url - First observed
lago_get_invoice - First observed
lago_get_plan - First observed
lago_get_subscription - First observed
lago_list_add_ons - First observed
lago_list_billable_metrics - First observed
lago_list_coupons - First observed
lago_list_credit_notes - First observed
lago_list_customer_subscriptions - First observed
lago_list_customers - First observed
lago_list_fees - First observed
lago_list_invoices - First observed
lago_list_plans - First observed
lago_list_subscriptions - First observed
lago_list_wallets
Related MCP Connectors
Read Orb customers, subscriptions, invoices, usage and costs; create or update customers.
Read subscriptions, customers, charges, orders; skip charges, cancel or activate subscriptions.
Read-only SaaS business intelligence from GA4, Stripe, and Google Search Console.
Read your Cakto sales: orders, revenue analytics, subscriptions, churn, customers and products.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables diagnosing Metronome usage-billing issues by inspecting events, running deterministic checks, and drafting customer replies through natural language in Claude Code.45 npm1MIT

Kordi MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceTrack, analyze, and act on your streaming & SaaS subscriptions from any AI agent.MIT
RevenueDot MCPofficial
AlicenseAqualityBmaintenanceEnables AI assistants such as Claude, ChatGPT and Cursor to manage an open-source subscription backend: setting up products, entitlements, offerings and packages, looking up customers, granting or revoking access, adding webhooks, and tracking RevenueCat imports. Tool names mirror RevenueCat's MCP tools, so existing prompts work unchanged.3817 npmMIT- AlicenseAqualityFmaintenanceProvides real-time Stripe subscription analytics including MRR, churn, failed payments, and expiring trials. Enables AI assistants to answer business health questions like 'How's my business doing?'8MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.