Review Token Usage
Use Monitor > Tokens to review token usage and optimization opportunities across MCP servers, toolkits, skills, and tool responses.
The page has two modes:
- Analyze shows usage metrics and context breakdowns.
- Optimize shows recommended actions and savings estimates.
Open Tokens
- Open Monitor > Tokens.
- Set the Start Date and End Date.
- Use Advanced Filters when you need to narrow results by user, AI agent, MCP server, or tool.
- Select Analyze or Optimize depending on the task.
The Analyze view starts with summary metrics for estimated conversation spend, response tokens, initial context tokens, and average tokens per call. It also shows tool token usage, toolkit context savings, biggest spenders, used models, and messages per conversation when data is available.
Recommended actions
The Optimize view groups suggested work into actions with estimated savings. In the captured state, recommendations include:
| Recommendation | Why it helps |
|---|---|
| Build toolkits for high-context MCP servers | MCP servers expose every tool definition to the agent. Curating a toolkit with only the tools a workflow needs reduces fixed context on every conversation. |
| Reduce skill size | Skills are injected into every conversation. Moving long examples or documentation into references lowers the baseline session cost. |
Use the recommendation cards as the starting point. Then open the related detail page to identify the exact server, toolkit, skill, or tool response to change.
Build toolkits recommendation
The Build toolkits for high-context MCP servers card points you toward MCP servers whose full tool list is adding too much context. Its next step is usually MCP Context, followed by creating or tightening a toolkit.
Reduce skill size recommendation
The Reduce skill size card points you toward oversized skills. Its next step is Skill Token Analysis, where you can review the skill and extract long content into references.
Analyze cards
Further down, the Analyze view summarizes the major context and response token sources.
| Card | What it means |
|---|---|
| MCP Context | Tool descriptions and input schemas loaded from MCP servers. |
| Toolkit Context | Context exposed by curated toolkits. |
| Skills Context | Skill content loaded into conversations. |
| Tool Responses | Tool outputs and response-mapping opportunities. |
Cards show totals, health indicators, and a View all action. Open the full view when a card shows a high count, a high token total, or an item marked for optimization.
MCP Context card
The MCP Context card opens MCP Context. Use it when one MCP server exposes many tools or has a large tool-description and input-schema footprint.
Toolkit Context card
The Toolkit Context card opens Toolkit Context. Use it to compare curated tool subsets and find toolkits that can be split or tightened.
Skills Context card
The Skills Context card opens Skill Token Analysis. Use it when a skill is large enough to raise the baseline cost of every conversation where it is loaded.
Tool Responses card
The Tool Responses card opens Tool Response Optimization. Use it to find tool outputs that need response mappings or output-format changes.
Empty states
Some areas can show no data when Willow has not recorded enough token-tracked activity in the selected period. If that happens:
- widen the date range
- remove advanced filters
- run tool calls through a connected AI client
- confirm Token Usage Analytics is enabled