---
title: "Get Voice Agent Analytics"
description: "Owner analytics for one voice agent over a date range."
---

> 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 Voice Agent Analytics

`get_agent_analytics` is a tool in the Speak AI MCP server. Owner analytics for one
voice agent over a date range.

## What does it do?

Owner analytics for one voice agent over a date range. Returns the range used;
conversation totals with completion rate, average duration and returning callers;
conversations per day split into web and phone; where callers are, their devices,
browsers and traffic sources; web callers who left without saying anything and the
number of open knowledge gaps (questions the agent could not answer); leads
captured, handoffs and action items; engagement, sentiment, top topics, end reasons
and satisfaction; busiest hours, weekdays and languages; and web versus phone
counts. Test calls are left out unless includeTests is true, and the count of test
calls is always returned. Leave start empty for all time; a start more than 5 years
before end is moved up to 5 years. A cross-company agentId returns 404.

## Parameters

`get_agent_analytics` takes 6 parameters, 1 of them required.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `agentId` | string | Yes | ID of the voice agent (from `list_voice_agents`) |
| `start` | string | No | Start of the range (ISO 8601 date). Omit for all time. Must be before end. |
| `end` | string | No | End of the range (ISO 8601 date). Defaults to now. |
| `tz` | string | No | IANA time zone used to group by day, hour and weekday, e.g. America/Toronto (default UTC). |
| `compare` | boolean | No | Also return the same KPIs for the period just before the range (default false). Needs start. |
| `includeTests` | boolean | No | Count the agent's test calls in the results (default false). |

## Behaviour

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

- 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

- [Voice agents](/mcp/tools/voice-agents/) lists the rest of the Voice agents
  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/voice-agents/get_agent_analytics/index.mdx