# io.usefulapi/lago (remote · lago.usefulapi.io)

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

- Trust score: 28/100 (low)
- Change this week: −41
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `lago.usefulapi.io`: 28/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-lago/lago.md), [page](https://verifymcp.io/servers/io-usefulapi-lago/lago)

## Channel facts

- Endpoint: `https://lago.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 4 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add --transport http io-usefulapi-lago https://lago.usefulapi.io/mcp
```

### Codex

```toml
[mcp_servers.io-usefulapi-lago]
url = "https://lago.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-lago": {
      "type": "remote",
      "url": "https://lago.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-lago --url https://lago.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-lago:
    url: "https://lago.usefulapi.io/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 28, −44)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.20 → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-08-02 (score 72, +54)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.20

### 2026-08-01 (score 18, −53)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.13 → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 71, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 68, −2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 69, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-27 (score 69, +57)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (24)

### `lago_list_customers` (~49 tokens)

List customers

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

Input parameters:

- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.

### `lago_get_customer` (~46 tokens)

Get customer

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

Input parameters:

- `external_customer_id` (string, required): The customer external unique identifier (from your application).

### `lago_get_customer_current_usage` (~86 tokens)

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.

Input parameters:

- `apply_taxes` (boolean): Whether taxes should be applied. Defaults to true.
- `external_customer_id` (string, required): The customer external unique identifier.
- `external_subscription_id` (string, required): The subscription's external unique identifier (required).

### `lago_get_customer_past_usage` (~102 tokens)

Get customer past usage

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

Input parameters:

- `billable_metric_code` (string): Filter usage to a specific billable metric code.
- `external_customer_id` (string, required): The customer external unique identifier.
- `external_subscription_id` (string, required): The subscription's external unique identifier (required).
- `periods_count` (integer): Number of past billing periods to return.

### `lago_list_customer_subscriptions` (~43 tokens)

List customer subscriptions

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

Input parameters:

- `external_customer_id` (string, required): The customer external unique identifier.

### `lago_get_customer_portal_url` (~47 tokens)

Get customer portal URL

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

Input parameters:

- `external_customer_id` (string, required): The customer external unique identifier.

### `lago_list_subscriptions` (~103 tokens)

List subscriptions

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

Input parameters:

- `external_customer_id` (string): Filter by customer external id.
- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.
- `plan_code` (string): Filter by plan code.
- `status` (string): Filter by a single status: active | pending | canceled | terminated. Default active.

### `lago_get_subscription` (~41 tokens)

Get subscription

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

Input parameters:

- `external_id` (string, required): The subscription's external unique identifier.

### `lago_list_plans` (~48 tokens)

List plans

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

Input parameters:

- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.

### `lago_get_plan` (~37 tokens)

Get plan

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

Input parameters:

- `code` (string, required): The plan's unique code.

### `lago_list_invoices` (~158 tokens)

List invoices

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

Input parameters:

- `external_customer_id` (string): Filter by customer external id.
- `issuing_date_from` (string): Filter invoices issued on/after this date (yyyy-mm-dd).
- `issuing_date_to` (string): Filter invoices issued on/before this date (yyyy-mm-dd).
- `page` (integer): Page number for pagination.
- `payment_status` (string): Filter by a single payment status: pending | failed | succeeded.
- `per_page` (integer): Number of records per page.
- `status` (string): Filter by a single status: draft | finalized | failed | pending | voided.

### `lago_get_invoice` (~45 tokens)

Get invoice

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

Input parameters:

- `lago_id` (string, required): The invoice's Lago id (UUID).

### `lago_list_billable_metrics` (~52 tokens)

List billable metrics

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

Input parameters:

- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.

### `lago_get_billable_metric` (~45 tokens)

Get billable metric

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

Input parameters:

- `code` (string, required): The billable metric's unique code.

### `lago_list_coupons` (~49 tokens)

List coupons

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

Input parameters:

- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.

### `lago_list_add_ons` (~51 tokens)

List add-ons

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

Input parameters:

- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.

### `lago_list_wallets` (~69 tokens)

List wallets

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

Input parameters:

- `external_customer_id` (string, required): The customer external unique identifier.
- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.

### `lago_list_credit_notes` (~65 tokens)

List credit notes

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

Input parameters:

- `external_customer_id` (string): Filter by customer external id.
- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.

### `lago_get_credit_note` (~48 tokens)

Get credit note

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

Input parameters:

- `lago_id` (string, required): The credit note's Lago id (UUID).

### `lago_list_fees` (~106 tokens)

List fees

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

Input parameters:

- `external_customer_id` (string): Filter by customer external id.
- `external_subscription_id` (string): Filter by subscription external id.
- `fee_type` (string): Filter by fee type: charge | add_on | subscription | credit | commitment.
- `page` (integer): Page number for pagination.
- `per_page` (integer): Number of records per page.

### `lago_analytics_gross_revenue` (~89 tokens)

Analytics: gross revenue

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

Input parameters:

- `currency` (string): Currency filter (ISO 4217, e.g. USD).
- `external_customer_id` (string): Filter revenue at the customer level.
- `months` (integer): Number of months to return.

### `lago_analytics_mrr` (~62 tokens)

Analytics: MRR

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

Input parameters:

- `currency` (string): Currency filter (ISO 4217, e.g. USD).
- `months` (integer): Number of months to return.

### `lago_create_customer` (~212 tokens)

Create customer

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

Input parameters:

- `country` (string): Billing country code (ISO 3166 alpha-2).
- `currency` (string): Customer currency (ISO 4217).
- `email` (string): Email of the customer.
- `external_id` (string, required): The customer external unique identifier (required, provided by your application).
- `legal_name` (string): Legal company name.
- `legal_number` (string): Legal company number.
- `metadata` (array): Structured metadata to attach to the customer (Lago expects an array of {key, value, display_in_invoice?} objects).
- `name` (string): Full name of the customer.
- `phone` (string): Phone number.
- `tax_identification_number` (string): Tax identification number.
- `timezone` (string): Customer timezone, e.g. America/New_York.
- `url` (string): Customer URL.

### `lago_create_event` (~179 tokens)

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": { ... } }.

Input parameters:

- `code` (string, required): The billable metric code this event targets (required).
- `external_subscription_id` (string, required): The subscription external id to link the event to (required).
- `precise_total_amount_cents` (string): Precise total amount in cents, used by the dynamic pricing model.
- `properties` (object): Additional event properties used to compute the fee (required for sum/max/unique aggregations).
- `timestamp`: Unix timestamp in seconds (or ISO); defaults to event reception time.
- `transaction_id` (string, required): Unique identifier for the event — the idempotency key (required).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-lago/lago#diagnostics

## Score history

- 2026-08-03: 28
- 2026-08-02: 72
- 2026-08-01: 18
- 2026-07-31: 71
- 2026-07-30: 68
- 2026-07-29: 70
- 2026-07-28: 69
- 2026-07-27: 69
- 2026-07-26: 12

## Links

- Remote endpoint: https://lago.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-lago/lago/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-lago/lago/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-lago/lago