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 lists the rest of the Voice agents category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.