---
title: "Get Embed Session"
description: "Owner analytics for an embed: one visit in full."
---

> 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.

# Get Embed Session

`get_embed_session` is a tool in the Speak AI MCP server. Owner analytics for an
embed: one visit in full.

## What does it do?

Owner analytics for an embed: one visit in full. Returns the session with the media
it opened (time watched, plays, seeks, furthest position, completed), the questions
asked in chat, and a paged list of its events in time order, plus how many sessions
the same viewer or browser has had on this embed. Use eventsPage and eventsPageSize
to read long timelines.

## Behaviour

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

- 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/get_embed_session/index.mdx