---
title: "amp mcp-analytics"
description: "Reference for amp mcp-analytics, which reads MCP servers, taxonomy, topics, and episodes."
product: general
lang: en
last_updated: 2026-11-18
token_estimate: 974
---
# amp mcp-analytics

`amp mcp-analytics` reads the MCP servers configured for a project, their topic taxonomy, and the episodes in each topic. This read-only command family requires the `analytics:read` scope.

## `amp mcp-analytics servers list`

Returns the MCP servers configured for the project. A project with no MCP servers returns 200 and an empty `data` array.

> For AI agents: a documentation index is available at [/docs/llms.txt](/docs/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--project` | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: `--project-id`. |

Requires the `analytics:read` scope.

## `amp mcp-analytics taxonomy get`

Returns the server's active topic tree. The resource id is the server id. A visible server with no pinned taxonomy returns 200, null run fields, and `nodes: []`. An unknown server returns 404.

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--project` | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: `--project-id`. |
| `--server` | string | Yes | Server id. Alias: `--server-id`. |
| `--parent` | string | No | Node selector. Omit it for every node in the active tree. `root` returns root nodes. Any other value is a stable topic id and returns that topic's direct children. An unknown parent returns 404 when a taxonomy is pinned. Alias: `--parent-id`. |

Requires the `analytics:read` scope.

## `amp mcp-analytics topics get`

Returns one topic and up to eight example episodes. Examples are not a page. Use the episode list to page through episodes.

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--project` | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: `--project-id`. |
| `--server` | string | Yes | Server id. Alias: `--server-id`. |
| `--topic` | string | Yes | Stable topic id. `root` is not a topic id. Alias: `--topic-id`. |

Requires the `analytics:read` scope.

## `amp mcp-analytics episodes list`

Returns a page of episode summaries for one topic. The default page size is 25 and the maximum is 100. Keep the same filters when following `next_cursor`.

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--project` | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: `--project-id`. |
| `--server` | string | Yes | Server id. Alias: `--server-id`. |
| `--topic` | string | Yes | Stable topic id. Alias: `--topic-id`. |
| `--started-after` | string | No | Include episodes that started at or after this RFC 3339 timestamp. |
| `--started-before` | string | No | Include episodes that started before this RFC 3339 timestamp. |
| `--lane` | string | No | Exact stored lane. |
| `--client-name` | string | No | Exact stored client name. |
| `--auth-type` | string | No | Exact stored auth type. |
| `--has-error` | boolean | No | Whether the episode recorded an error. |
| `--is-thrash` | boolean | No | Whether the episode was classified as thrash. |
| `--cursor` | string | No | Opaque cursor from `pagination.next_cursor` on the previous response. Alias: `--next-cursor`. |
| `--limit` | integer | No | Number of episodes to return. Defaults to 25, maximum 100. |

Requires the `analytics:read` scope.

## `amp mcp-analytics episodes get`

Returns one episode, including its project, server, auth type, and topic breadcrumb. A missing or cross-project episode returns 404.

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--project` | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: `--project-id`. |
| `--episode` | string | Yes | Episode id returned by the topic or episode list. Alias: `--episode-id`. |

Requires the `analytics:read` scope.

