---
title: "Live API + MCP usage counters"
method: GET
path: "/v1/usage"
tags: ["Meta"]
---

# Live API + MCP usage counters

`GET /v1/usage`

## Request

- Base URL: `https://api.rossdata.dev`
- URL: `https://api.rossdata.dev/v1/usage`
- Auth: none declared

Best-effort server-side call counters for the REST API and MCP server — totals, daily volume, top endpoints/tools. Live (never cached); returns an HTML dashboard when requested with Accept: text/html.

## Response `200`

OK

- UsageReport: Best-effort server-side call counters, durable across deploys. Live — never cached.
  - `configured` boolean: Whether a counter store (Vercel KV / Upstash) is linked
  - `generated` string, date-time
  - `totals` object
    - `all` integer
    - `mcp` integer
    - `rest` integer
  - `firstSeen` string, date-time, nullable
  - `lastSeen` string, date-time, nullable

---

[API](https://skmtc.dev/rossdata/apis/rossdata-dev-api.md) · [All operations](https://skmtc.dev/rossdata/apis/rossdata-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rossdata/apis/rossdata-dev-api/revisions/8c796f2e258c?raw)