Usage Lab is an MCP server published by dev.pages.usage-lab, hosted at usage-lab.pages.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 6 tools, including get_docs, list_meters, create_meter, record_usage_events, get_meter_rollups.
Record idempotent usage events and read monthly per-customer rollups (Usage Lab metering API).
1 connections through 4 shared values. Tap any node.
Quickstart for the Usage Lab metering API and this MCP server: how to get a free API key, connect, create a meter, record idempotent usage events and read rollups. No API key needed.
No parameters.
{
"name": "get_docs",
"title": "Usage Lab quickstart",
"description": "Quickstart for the Usage Lab metering API and this MCP server: how to get a free API key, connect, create a meter, record idempotent usage events and read rollups. No API key needed.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Usage Lab quickstart",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the meters on your Usage Lab account (key, name, aggregation sum | count | unique_count). Needs your API key (Authorization: Bearer).
No parameters.
{
"name": "list_meters",
"title": "List meters",
"description": "List the meters on your Usage Lab account (key, name, aggregation sum | count | unique_count). Needs your API key (Authorization: Bearer).",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "List meters",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a meter once (POST /api/v1/meters). aggregation: sum (add up value, e.g. tokens), count (number of events, e.g. tool calls) or unique_count (distinct unique_value, e.g. active users). Re-creating an existing key returns meter_exists (harmless). Free plan: 3 meters. Needs your API key.
| Parameter | Type | Description |
|---|---|---|
| key * | string | 1-64 chars of letters, digits, _ . - (e.g. agent_tool_calls). |
| name | string | Optional display name (defaults to key). |
| aggregation * | string | one of ["sum","count","unique_count"] |
| stripe_event_name | string | Optional Stripe Billing Meter event_name for Stripe push (Pro/Ultra). |
{
"name": "create_meter",
"title": "Create a meter",
"description": "Create a meter once (POST /api/v1/meters). aggregation: sum (add up value, e.g. tokens), count (number of events, e.g. tool calls) or unique_count (distinct unique_value, e.g. active users). Re-creating an existing key returns meter_exists (harmless). Free plan: 3 meters. Needs your API key.",
"inputSchema": {
"type": "object",
"required": [
"key",
"aggregation"
],
"properties": {
"key": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,63}$",
"description": "1-64 chars of letters, digits, _ . - (e.g. agent_tool_calls)."
},
"name": {
"type": "string",
"description": "Optional display name (defaults to key)."
},
"aggregation": {
"enum": [
"sum",
"count",
"unique_count"
],
"type": "string"
},
"stripe_event_name": {
"type": "string",
"description": "Optional Stripe Billing Meter event_name for Stripe push (Pro/Ultra)."
}
}
},
"annotations": {
"title": "Create a meter",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Record 1-100 usage events in one all-or-nothing batch (POST /api/v1/usage). Every event MUST carry its own idempotency_key; retrying with the same keys is safe (results say created / duplicate / conflict). Needs your API key.
| Parameter | Type | Description |
|---|---|---|
| events * | array |
{
"name": "record_usage_events",
"title": "Record usage events",
"description": "Record 1-100 usage events in one all-or-nothing batch (POST /api/v1/usage). Every event MUST carry its own idempotency_key; retrying with the same keys is safe (results say created / duplicate / conflict). Needs your API key.",
"inputSchema": {
"type": "object",
"required": [
"events"
],
"properties": {
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"idempotency_key",
"subscription"
],
"properties": {
"meter": {
"type": "string",
"description": "Meter key or id. Optional only if the account has exactly one meter."
},
"value": {
"type": "number",
"description": "Required for sum meters (e.g. tokens). Defaults to 1 for count meters."
},
"timestamp": {
"type": [
"string",
"number"
],
"description": "ISO-8601 or unix seconds/ms. Defaults to now. Max 30 days old, max 5 minutes in the future."
},
"properties": {
"type": "object",
"description": "Optional JSON stored with the event, e.g. {\"traffic_class\":\"ai_agent\",\"tool\":\"search\"}."
},
"subscription": {
"type": "string",
"maxLength": 200,
"description": "Required. Your customer or subscription id (who to bill)."
},
"unique_value": {
"type": [
"string",
"number"
],
"description": "Required for unique_count meters (e.g. a user id)."
},
"idempotency_key": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Required. A stable id for this event (e.g. sha256 of run_id:step:tool_call_id, or your provider response id). Reuse it on retries: same key + same payload returns duplicate and counts once; same key + different payload is a conflict and the original is kept."
}
}
},
"maxItems": 100,
"minItems": 1
}
}
},
"annotations": {
"title": "Record usage events",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Monthly totals per customer for one meter, recomputed from raw events (GET /api/v1/meters/{meter}/rollups). Returns total_quantity and per-subscription quantity and event_count. Needs your API key.
| Parameter | Type | Description |
|---|---|---|
| meter * | string | Meter key or id. |
| month | string | YYYY-MM (UTC). Defaults to the current month. |
| subscription | string | Optional: only this customer/subscription. |
{
"name": "get_meter_rollups",
"title": "Get monthly rollups",
"description": "Monthly totals per customer for one meter, recomputed from raw events (GET /api/v1/meters/{meter}/rollups). Returns total_quantity and per-subscription quantity and event_count. Needs your API key.",
"inputSchema": {
"type": "object",
"required": [
"meter"
],
"properties": {
"meter": {
"type": "string",
"description": "Meter key or id."
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "YYYY-MM (UTC). Defaults to the current month."
},
"subscription": {
"type": "string",
"description": "Optional: only this customer/subscription."
}
}
},
"annotations": {
"title": "Get monthly rollups",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your account: plan, event and meter limits, event_count and first_event_at (GET /api/v1/account). Needs your API key.
No parameters.
{
"name": "get_account",
"title": "Get account",
"description": "Your account: plan, event and meter limits, event_count and first_event_at (GET /api/v1/account). Needs your API key.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Usage Lab meters usage for usage-based billing. Typical flow: list_meters (or create_meter once), then record_usage_events with a stable idempotency_key per event (reuse the same key on retries: it returns duplicate and counts once), then get_meter_rollups for monthly per-customer totals. Account tools need the user's own Usage Lab API key sent as 'Authorization: Bearer <key>' on this MCP connection (free key at https://usage-lab.pages.dev/signup/). get_docs needs no key.
Names, descriptions and schemas were written by the server and are shown as data.