---
title: "List Embed Sessions"
description: "Owner analytics for an embed: list the visits (sessions) to one embed, newest first by default."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List Embed Sessions

`list_embed_sessions` is a tool in the Speak AI MCP server. Owner analytics for an
embed: list the visits (sessions) to one embed, newest first by default.

## What does it do?

Owner analytics for an embed: list the visits (sessions) to one embed, newest first
by default. Each session has its start and last activity time, whether it is still
live, total and active time, media opened, time watched, questions asked, the
viewer's email and name when they identified themselves, their country, browser,
device and referrer, campaign tags, and whether it was a bot. Returns sessions with
totalCount, page and pageSize. Use `get_embed_session` with a session's _id for its
full timeline.

## Behaviour

The Speak AI MCP server publishes these behaviour hints for `list_embed_sessions`.

- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Embed players](/mcp/tools/embed-other/) lists the rest of the Embed players
  category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/embed-other/list_embed_sessions/index.mdx