---
title: "Admin Mcp Tool Usage"
method: GET
path: "/v1/admin/mcp/tool-usage"
---

# Admin Mcp Tool Usage

`GET /v1/admin/mcp/tool-usage`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/admin/mcp/tool-usage`
- Auth: none declared

Aggregate MCP ``tools/call`` audit rows over the last ``days``.

Shape::

    {
      "window_days": <int>,
      "total_calls": <int>,
      "by_tool": [
        {"tool_name", "calls", "errors", "error_rate",
         "p50_latency_ms", "p95_latency_ms"},
        ...
      ],
      "by_source": [
        {"caller_source", "calls"},
        ...
      ],
      "top_callers": [
        {"caller_id", "calls"},
        ...
      ],
    }

Returns the empty shape when the audit table is missing (pre-0161
deploys) — the FE renders "no data yet" rather than crashing.

## Query parameters

- `days` integer
- `top_callers_limit` integer

## Headers

- `x-storyflo-email-token` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)