mcp

List Usage

Paged list of MCP usage events for the calling org, with aggregated stats over the same filter window.

Uses the (org_uuid, ts DESC) index for the range scan and one $facet aggregation to return events, totals, and the three breakdown buckets in a single round-trip. Stats reflect the full filtered set, not just the visible page.

get/v1/mcp/usage

Request

  • Base URL: https://api.sonenta.dev
  • URL: https://api.sonenta.dev/v1/mcp/usage
  • Auth: none declared

Query parameters

fromstring date-time nullable

ISO8601 lower bound (inclusive). Defaults to the start of the current UTC month.

tostring date-time nullable

ISO8601 upper bound (exclusive). Defaults to now.

cmdstring nullable

Filter rows by command (e.g. create_key).

userstring nullable

Filter by acting user uuid.

api_keystring nullable

Filter by api-key uuid.

limitinteger
offsetinteger

Response

Successful Response

range_fromstring date-time required
range_tostring date-time required
totalinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.