io.usefulapi/lago

REMOTE · LAGO.USEFULAPI.IO · SCANNED AUG 3

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

Available components

−41 this week 28 28 Trust /100

Trust breakdown (6 categories)

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. How we score →

Endpoint Security46

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes. View diagnostics → Unverified
HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability0

Schema not yet verified: we couldn't read the endpoint's schema.Unverified

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage0

Tool coverage not yet verified: we couldn't read the endpoint's tools.Unverified

Capabilities0

Capabilities not yet verified: we couldn't read the endpoint's capabilities.Unverified

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

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · lago.usefulapi.io

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# ~/.codex/config.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
    }
  }
}

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.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 we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 −44
- Endpoint reachability: reachable → not serving MCP ▼ security
- Authorization: pass → unverified ▼ security
- Stability: 0.20 → unverified ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: fail → unverified ▼ functional
2 Aug 26 +54
- Authorization: unverified → pass ▲ security
- Transport: fail → pass ▲ security
- MCP protocol: unverified → fail ▼ functional
- Endpoint reachability: not serving MCP → reachable ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Stability: unverified → 0.20 ▲ functional
1 Aug 26 −53
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.13 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Transport: pass → fail ▼ security
- Capabilities: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
31 Jul 26 +3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +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.
28 Jul 26 0
- Stability: unverified → 0.03 ▲ functional
27 Jul 26 +57
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional

Show 5 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://lago.usefulapi.io/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=usefulapi.io	CN=WE1,O=Google Trust Services,C=US	17 Jul 2026	15 Oct 2026	ECDSA 256	ECDSA-SHA256	7e610973e2ee63db13687aca49a501a6
SANs: usefulapi.io, lago.usefulapi.io, *.lago.usefulapi.io
CN=WE1,O=Google Trust Services,C=US (CA)	CN=GTS Root R4,O=Google Trust Services LLC,C=US	13 Dec 2023	20 Feb 2029	ECDSA 256	ECDSA-SHA384	7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA)	CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE	15 Nov 2023	28 Jan 2028	ECDSA 384	SHA256-RSA	7fe530bf331343bedd821610493d8a1b

DNSSEC insecure

Validation of lago.usefulapi.io. — Not signed

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
io.	present	57355	8	Verified
usefulapi.io.	absent			Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	200

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://lago.usefulapi.io/mcp	Verified	200
http (plaintext)	http://lago.usefulapi.io/mcp	Inconclusive	401

MCP tools — 24 exposed · ~1,832 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

lago_analytics_gross_revenue Analytics: gross revenue ~89

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

lago_analytics_mrr Analytics: MRR ~62

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

Input Output Examples

Name	Type	Req	Description
currency	string	—	Currency filter (ISO 4217, e.g. USD).
months	integer	—	Number of months to return.

No output schema declared.

No examples provided.

lago_create_customer Create customer ~212

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

Input Output Examples

Name	Type	Req	Description
country	string	—	Billing country code (ISO 3166 alpha-2).
currency	string	—	Customer currency (ISO 4217).
email	string	—	Email of the customer.
external_id	string	yes	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.

No output schema declared.

No examples provided.

lago_create_event Create usage event ~179

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 Output Examples

Name	Type	Req	Description
code	string	yes	The billable metric code this event targets (required).
external_subscription_id	string	yes	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	yes	Unique identifier for the event — the idempotency key (required).

No output schema declared.

No examples provided.

lago_get_billable_metric Get billable metric ~45

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

Input Output Examples

Name	Type	Req	Description
code	string	yes	The billable metric's unique code.

No output schema declared.

No examples provided.

lago_get_credit_note Get credit note ~48

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

Input Output Examples

Name	Type	Req	Description
lago_id	string	yes	The credit note's Lago id (UUID).

No output schema declared.

No examples provided.

lago_get_customer Get customer ~46

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

Input Output Examples

Name	Type	Req	Description
external_customer_id	string	yes	The customer external unique identifier (from your application).

No output schema declared.

No examples provided.

lago_get_customer_current_usage Get customer current usage ~86

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

Input Output Examples

Name	Type	Req	Description
apply_taxes	boolean	—	Whether taxes should be applied. Defaults to true.
external_customer_id	string	yes	The customer external unique identifier.
external_subscription_id	string	yes	The subscription's external unique identifier (required).

No output schema declared.

No examples provided.

lago_get_customer_past_usage Get customer past usage ~102

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

Input Output Examples

Name	Type	Req	Description
billable_metric_code	string	—	Filter usage to a specific billable metric code.
external_customer_id	string	yes	The customer external unique identifier.
external_subscription_id	string	yes	The subscription's external unique identifier (required).
periods_count	integer	—	Number of past billing periods to return.

No output schema declared.

No examples provided.

lago_get_customer_portal_url Get customer portal URL ~47

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

Input Output Examples

Name	Type	Req	Description
external_customer_id	string	yes	The customer external unique identifier.

No output schema declared.

No examples provided.

lago_get_invoice Get invoice ~45

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

Input Output Examples

Name	Type	Req	Description
lago_id	string	yes	The invoice's Lago id (UUID).

No output schema declared.

No examples provided.

lago_get_plan Get plan ~37

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

Input Output Examples

Name	Type	Req	Description
code	string	yes	The plan's unique code.

No output schema declared.

No examples provided.

lago_get_subscription Get subscription ~41

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

Input Output Examples

Name	Type	Req	Description
external_id	string	yes	The subscription's external unique identifier.

No output schema declared.

No examples provided.

lago_list_add_ons List add-ons ~51

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

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number for pagination.
per_page	integer	—	Number of records per page.

No output schema declared.

No examples provided.

lago_list_billable_metrics List billable metrics ~52

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

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number for pagination.
per_page	integer	—	Number of records per page.

No output schema declared.

No examples provided.

lago_list_coupons List coupons ~49

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

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number for pagination.
per_page	integer	—	Number of records per page.

No output schema declared.

No examples provided.

lago_list_credit_notes List credit notes ~65

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

Input Output Examples

Name	Type	Req	Description
external_customer_id	string	—	Filter by customer external id.
page	integer	—	Page number for pagination.
per_page	integer	—	Number of records per page.

No output schema declared.

No examples provided.

lago_list_customer_subscriptions List customer subscriptions ~43

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

Input Output Examples

Name	Type	Req	Description
external_customer_id	string	yes	The customer external unique identifier.

No output schema declared.

No examples provided.

lago_list_customers List customers ~49

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

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number for pagination.
per_page	integer	—	Number of records per page.

No output schema declared.

No examples provided.

lago_list_fees List fees ~106

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

lago_list_invoices List invoices ~158

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

lago_list_plans List plans ~48

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

Input Output Examples

Name	Type	Req	Description
page	integer	—	Page number for pagination.
per_page	integer	—	Number of records per page.

No output schema declared.

No examples provided.

lago_list_subscriptions List subscriptions ~103

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

lago_list_wallets List wallets ~69

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

Input Output Examples

Name	Type	Req	Description
external_customer_id	string	yes	The customer external unique identifier.
page	integer	—	Page number for pagination.
per_page	integer	—	Number of records per page.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	12
27 Jul	69
28 Jul	69
29 Jul	70
30 Jul	68
31 Jul	71
1 Aug	18
2 Aug	72
3 Aug	28