---
title: "Traces By Tool"
method: GET
path: "/api/v1/admin/mcp-observability/traces-by-tool"
tags: ["Admin APIs", "MCP Observability"]
---

# Traces By Tool

`GET /api/v1/admin/mcp-observability/traces-by-tool`

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `tools` string, nullable
- `environment` string, nullable
- `session_type` string, nullable
- `clients` string[], nullable
- `include_internal` boolean

## Response `200`

Successful Response

- ToolMetric[]
  - `tool` string, required
  - `total` integer
  - `errors` integer
  - `error_rate_pct` number

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)