{"data":{"name":"dev.pages.usage-lab/usage-lab","title":"Usage Lab","description":"Record idempotent usage events and read monthly per-customer rollups (Usage Lab metering API).","version":"0.1.0","websiteUrl":"https://usage-lab.pages.dev/docs/mcp/","repositoryUrl":null,"remotes":[{"type":"streamable-http","url":"https://usage-lab.pages.dev/mcp","headers":[{"description":"Bearer <your Usage Lab API key> (free key at https://usage-lab.pages.dev/signup/). Optional for get_docs and tools/list.","isSecret":true,"name":"Authorization"}]}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-11T00:26:15.332Z","updatedAt":"2026-11-11T00:26:15.332Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"dev.pages.usage-lab/usage-lab","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-11T00:26:15.332Z","title":"Usage Lab","description":"Record idempotent usage events and read monthly per-customer rollups (Usage Lab metering API).","websiteUrl":"https://usage-lab.pages.dev/docs/mcp/","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"dev.pages.usage-lab/usage-lab","endpointFingerprint":"0c7be95406a2bfdcbd497b445086e59a7119d86c3d5c43830c2aa57d2cd98396","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","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)."},"aggregation":{"type":"string","enum":["sum","count","unique_count"]},"name":{"type":"string","description":"Optional display name (defaults to key)."},"stripe_event_name":{"type":"string","description":"Optional Stripe Billing Meter event_name for Stripe push (Pro/Ultra)."}},"required":["key","aggregation"]},"annotations":{"title":"Create a meter","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"8acc31efdc0c576e6b33a560886501ee2035b2c83f772bba2588a63fe76184a0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T12:48:36.526Z","metadataTrust":"untrusted"},{"serverName":"dev.pages.usage-lab/usage-lab","endpointFingerprint":"0c7be95406a2bfdcbd497b445086e59a7119d86c3d5c43830c2aa57d2cd98396","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,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"79e6f464a5dee424ed662881fc6d27edaf0e3b4322488c248bb257c764675581","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T12:48:36.526Z","metadataTrust":"untrusted"},{"serverName":"dev.pages.usage-lab/usage-lab","endpointFingerprint":"0c7be95406a2bfdcbd497b445086e59a7119d86c3d5c43830c2aa57d2cd98396","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,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"3e08f88f98add5618f7639828c2d58fd431cf73a0b9949093aba66d85258f781","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T12:48:36.526Z","metadataTrust":"untrusted"},{"serverName":"dev.pages.usage-lab/usage-lab","endpointFingerprint":"0c7be95406a2bfdcbd497b445086e59a7119d86c3d5c43830c2aa57d2cd98396","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","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."}},"required":["meter"]},"annotations":{"title":"Get monthly rollups","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"18dea410be97da263957d97710d00e46adaa9c0a414bf8802fa602fa006f7428","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T12:48:36.526Z","metadataTrust":"untrusted"},{"serverName":"dev.pages.usage-lab/usage-lab","endpointFingerprint":"0c7be95406a2bfdcbd497b445086e59a7119d86c3d5c43830c2aa57d2cd98396","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,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"70e4c62556293e898483fda968910de1795e1ba269c8608736ba958529bf02f5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T12:48:36.526Z","metadataTrust":"untrusted"},{"serverName":"dev.pages.usage-lab/usage-lab","endpointFingerprint":"0c7be95406a2bfdcbd497b445086e59a7119d86c3d5c43830c2aa57d2cd98396","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","properties":{"events":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":255,"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."},"meter":{"type":"string","description":"Meter key or id. Optional only if the account has exactly one meter."},"subscription":{"type":"string","maxLength":200,"description":"Required. Your customer or subscription id (who to bill)."},"value":{"type":"number","description":"Required for sum meters (e.g. tokens). Defaults to 1 for count meters."},"unique_value":{"type":["string","number"],"description":"Required for unique_count meters (e.g. a user id)."},"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\"}."}},"required":["idempotency_key","subscription"]}}},"required":["events"]},"annotations":{"title":"Record usage events","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"2c215bcecb3bbbe2ab03bcd53007e27e15b862df027165154c9de83b5887b78b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T12:48:36.526Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"0c7be95406a2bfdcbd497b445086e59a7119d86c3d5c43830c2aa57d2cd98396","protocol":"streamable-http","status":"indexed","toolCount":6,"observedAt":"2026-11-17T12:48:36.526Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"dev.pages.usage-lab/usage-lab":{"url":"https://usage-lab.pages.dev/mcp"}}},"Cursor":{"mcpServers":{"dev.pages.usage-lab/usage-lab":{"url":"https://usage-lab.pages.dev/mcp"}}},"VS Code":{"servers":{"dev.pages.usage-lab/usage-lab":{"type":"http","url":"https://usage-lab.pages.dev/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://usage-lab.pages.dev/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:dev.pages.usage-lab%2Fusage-lab","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/dev.pages.usage-lab%2Fusage-lab","name":"dev.pages.usage-lab/usage-lab","description":"Record idempotent usage events and read monthly per-customer rollups (Usage Lab metering API).","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://usage-lab.pages.dev/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://usage-lab.pages.dev/docs/mcp/","repositoryUrl":null,"version":"0.1.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"dev.pages.usage-lab/usage-lab","status":"online","lastCheckedAt":"2026-11-20T07:16:24.806Z","lastSuccessfulCheck":"2026-11-20T07:16:24.806Z","latencyMs":59,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T07:16:24.806Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T07:16:24.806Z"},"security":null,"timestamps":{"createdAt":"2026-11-11T00:26:15.332Z","updatedAt":"2026-11-11T00:26:15.332Z","observedAt":"2026-11-20T07:16:24.806Z"},"compatibility":{"serverVersion":"0.1.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}