---
title: "Get MCP analytics"
method: GET
path: "/api/v2/projects/{slug}/analytics/mcp/"
tags: ["Analytics"]
---

# Get MCP analytics

`GET /api/v2/projects/{slug}/analytics/mcp/`

## Request

- Base URL: `https://app.biel.ai`
- URL: `https://app.biel.ai/api/v2/projects/{slug}/analytics/mcp/`
- Auth: API key in header `Authorization`

Aggregate KPIs and daily activity for conversations that originated from the MCP server.

**Required permission:** `analytics_read`

## Path parameters

- `slug` string, required

## Query parameters

- `from` string, date
- `to` string, date

## Response `200`

MCP analytics retrieved successfully

- McpAnalytics: KPIs and daily activity for conversations that originated from the MCP server.
  - `kpis` object, required
    - `chats_count` integer, required: Total number of MCP chats in the date range.
    - `messages_count` integer, required: Number of human queries received via MCP.
    - `unique_users_count` integer, required: Distinct end users (resolved by IP, with chats lacking an IP each counting as one user).
  - `activity` object, required
    - `chats_per_day` DailyCount[], required: MCP chats created per day. Always covers every day of the range.
      - `day` string, date, required: ISO-8601 date (`YYYY-MM-DD`).
      - `count` integer, required: Number of events recorded on this day.
    - `top_countries` TopCountry[], required: Top 10 countries by MCP chat volume.
      - `name` string, required: Country name. `Unknown` when the IP could not be resolved.
      - `flag` string, required: Country flag emoji. Empty string for `Unknown`.
      - `count` integer, required

## Other responses

- `400`: Bad request. Invalid or missing data.
- `403`: Forbidden. Missing permissions.
- `404`: Resource not found.

---

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