---
title: "Org Mcp Usage"
method: GET
path: "/v1/orgs/{org_uuid}/mcp/usage"
tags: ["mcp"]
---

# Org Mcp Usage

`GET /v1/orgs/{org_uuid}/mcp/usage`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/orgs/{org_uuid}/mcp/usage`
- Auth: none declared

Dashboard-facing twin of GET /v1/mcp/usage.

Same shape, same filters, same defaults — auth is Bearer JWT and the
caller must be admin or owner of `org_uuid`.

## Path parameters

- `org_uuid` string, required

## Query parameters

- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `cmd` string, nullable
- `user` string, nullable
- `api_key` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- UsageReport
  - `range_from` string, date-time, required
  - `range_to` string, date-time, required
  - `events` UsageEventOut[], required
    - `ts` string, date-time, required
    - `cmd` string, required
    - `category` string, required
    - `units` integer, required
    - `duration_ms` integer, required
    - `status` integer, required
    - `user_uuid` string, nullable, required
    - `api_key_uuid` string, nullable, required
    - `args_size_bytes` integer, required
  - `total` integer, required
  - `stats` UsageStats, required
    - `total_events` integer, required
    - `total_units` integer, required
    - `by_category` CountBucket[], required
      - `label` string, required
      - `count` integer, required
    - `by_cmd` CountBucket[], required
      - `label` string, required
      - `count` integer, required
    - `by_status` CountBucket[], required
      - `label` string, required
      - `count` integer, required

## Other responses

- `422`: Validation Error

---

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