Skip to main content

​
What are Agent Goals?

Tool call logs show you what happened in a session, but not why. Agent Goals use AI to classify the goal behind each session, turning raw event data into actionable insight about what your users are trying to do and whether they were successful. Agent goals was built with a full product workflow in mind, helping you answer questions like:
  • What are the most common use cases for agents using my product?
  • How often are those use cases successful vs. not?
  • What are new use cases?

​
How Goals Work

MCPcat’s AI analyzes patterns across your project’s sessions to generate a set of goals. To start classifying goals, we need a minimum threshold of sessions and tool calls so our algorithm can begin clustering and classifying common goals:
RequirementThreshold
Sessions~200 sessions in the project
Tool calls~1,000 tool call events
Once these thresholds are met, MCPcat begins periodically discovering goals based on samples of sessions and classifying all new sessions into a goal once the session has completed.

​
Session Goal

In each Session Replay, you can find the session goal. The session goal includes information that helps you understand what the goal was for that session and whether it was achieved or not.
session goal card
PropertyDescription
NameA short label for the goal
DescriptionA longer explanation of the user intent
StatusWhether the goal was accomplished or failed for a given session
ReasoningAI-generated explanation of why the goal was classified as accomplished or failed
Goals go through different states depending on whether you’re looking at a project or an individual session:
  • Learning: The project doesn’t have enough data to generate goals
  • Processing: This individual session is still being analyzed or has not yet completed
  • Active: Goals are available and ready to view

​
Goal Success Rate

goal success rate
On the Dashboard, you can see an overview of the agent goals across your entire project. You can see the distribution of goals across all recent sessions, how often a goal was succeeding or failing, and a graph of goal success rate over time. Use this to identify goals where users frequently fail. These are your highest-impact improvement opportunities.

​
Filtering by Goal

On the sessions list page, a Goals filter becomes available once goals are active for your project. Use it to find all sessions where agents had a specific goal. For example, filter to “Debug authentication flow” to see every session where an agent was trying to debug auth.