# Яндекс Метрика: Список счётчиков Метрики — MCP-инструмент (tool)

**MCP-инструмент (tool) для Яндекс Метрики:** Возвращает счётчики Яндекс Метрики, доступные токену (Management API).

Техническое имя: `list_counters`

## Какую задачу решает

> Я хочу посмотреть счётчиков Метрики.

Возвращает счётчики Яндекс Метрики, доступные токену (Management API).

## Когда использовать

Используйте эту возможность, когда нужен результат «Список счётчиков Метрики» без ручной работы в интерфейсе Яндекс Метрики. Операция выполняется только по вызову из AI-приложения.

## Что нужно передать

- `search` — **необязательно**. Подстрока для фильтра счётчиков по имени или сайту, без учёта регистра.
- `perPage` — **необязательно**. Максимум счётчиков в ответе. По умолчанию 100.
- `offset` — **необязательно**. Смещение для постраничной выдачи, отсчёт с 1.

## Что вернёт

Возвращает счётчики Яндекс Метрики, доступные токену (Management API).

## Что изменится в Яндекс Метрике

Инструмент только читает данные или состояние подключения и не изменяет их.

## Пример запроса

> Посмотреть счётчиков Метрики в Яндекс Метрике. Если не хватает обязательных идентификаторов, сначала уточни их.

## Возможные ошибки и ограничения

У каждого счётчика есть id, name и site2 (домен сайта) — id используется в get_statistics и list_goals. Фильтр по подстроке имени или сайта задаётся параметром `search`.

Доступ также зависит от прав токена, квот и ограничений исходного API.

## Связанные MCP-инструменты

- [Список целей счётчика](./list-goals.md) — `list_goals`

## Технические сведения

- **Воздействие:** только чтение
- **Группа:** Счётчики и цели
- **Источник описания:** регистрация `list_counters` в `src/tools/counters.ts`
- [Полный технический справочник](../TOOLS.md)
- [Все MCP-возможности](./index.md)