---
title: "List Egress Top Tools Rollup"
method: GET
path: "/api/v1/edges/egress/top-tools"
tags: ["Edge"]
---

# List Egress Top Tools Rollup

`GET /api/v1/edges/egress/top-tools`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/edges/egress/top-tools`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Lists the most frequently used MCP tools across the Edges the caller manages.

## Query parameters

- `page_size` integer: The pageSize field.
- `since` string, int64: The since field.
- `until` string, int64: The until field.

## Response `200`

Successful response

- C1ApiEdgeV1EdgeServiceListEgressTopToolsRollupResponse: The EdgeServiceListEgressTopToolsRollupResponse message.
  - `edgeCount` integer: Number of authorized Edges included. Zero means the caller manages no Edges, as distinct from Edges that have no traffic yet.
  - `tools` C1ApiEdgeV1TBTopTool[], nullable: Ordered by call_count descending, limited to page_size. No pagination cursor -- this is a fixed top-N, not a full list.
    - `allowedCount` string, uint64: The allowedCount field.
    - `callCount` string, uint64: The callCount field.
    - `deniedCount` string, uint64: The deniedCount field.
    - `distinctAgentCount` string, uint64: The distinctAgentCount field.
    - `toolName` string: The toolName field.
    - `toolOperation` string: The toolOperation field.
    - `totalResponseBytes` string, uint64: The totalResponseBytes field.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/edges/egress/top-tools/get.md)

---

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