documentation/docs/mcp/autovisualiser-mcp.md
import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed'; import GooseBuiltinInstaller from '@site/src/components/GooseBuiltinInstaller'; import ImageCarousel from '@site/src/components/ImageCarousel';
<YouTubeShortEmbed videoUrl="https://www.youtube.com/embed/txh6DlzPwNo" />The Auto Visualiser extension enables goose to automatically generate interactive data visualizations directly in your conversation. This built-in extension uses MCP Apps to render charts, graphs, maps, and diagrams inline in goose Desktop.
This guide will cover enabling and using the Auto Visualiser MCP Server.
configure command:goose configure
Toggle Extensions┌ goose-configure
│
◇ What would you like you configure?
│ Toggle Extensions
│
◆ Enable extensions: (use "space" to toggle and "enter" to submit)
// highlight-start
│ ● autovisualiser
// highlight-end
└ Extension settings updated successfully
:::info Auto Visualiser now uses MCP Apps, which means visualizations can render inline in chat and expand into fullscreen or picture-in-picture modes in goose Desktop. :::
The Auto Visualiser automatically detects when data would benefit from visualization and chooses the most appropriate chart or diagram type. It renders those visualizations as interactive MCP Apps inside goose Desktop.
| Chart Type | Description | Detected When Prompt Implies |
|---|---|---|
| Sankey Diagrams | Flow data visualization showing relationships and quantities | Flow or process data |
| (workflows, funnels, process datasets) | ||
| Radar Charts | Multi-dimensional data comparison (spider charts) | Multi-dimensional comparisons |
| (performance metrics, feature comparisons) | ||
| Donut/Pie Charts | Categorical data visualization with support for multiple charts | Categorical proportions |
| (percentage breakdowns, category distributions) | ||
| Treemap Visualizations | Hierarchical data with proportional area representation | Hierarchical data |
| (nested categories, organizational structures) | ||
| Chord Diagrams | Relationship and flow visualization between entities | Relationship matrices |
| (network connections, cross-references) | ||
| Interactive Maps | Geographic data visualization with location markers using Leaflet | Geographic information |
| (location data, coordinates, addresses) | ||
| Mermaid Diagrams | Flowcharts, sequence diagrams, Gantt charts, and other diagram types using Mermaid syntax | Diagram creation |
| (flowcharts, sequence diagrams, architecture diagrams) | ||
| Line/Bar/Scatter Charts | Traditional chart types for data analysis | Time series data |
| (historical data, trends over time) |
<ImageCarousel id="flappy" width="40%" images={[
require('/blog/2025-08-27-autovisualiser-with-mcp-ui/sankey.png').default, require('/blog/2025-08-27-autovisualiser-with-mcp-ui/treemap.png').default, ]} names={[ "Sankey", "Treemap" ]} />
When goose decides that your data should be visualized, the Auto Visualiser extension returns an MCP App for the selected chart type. goose Desktop then renders that app directly in the conversation.
Depending on the visualization, you can:
In this example, I'll have goose analyze some sales data and automatically visualize it using the Auto Visualiser extension.
I have quarterly sales data for different product categories. Can you help me understand:
1. The hierarchical breakdown of revenue across our nested product categories
2. How our performance metrics compare across all four quarters
3. The customer flow through our sales funnel process
Here's the data:
- Electronics: Q1: $150k, Q2: $180k, Q3: $220k, Q4: $195k
- Clothing: Q1: $120k, Q2: $140k, Q3: $160k, Q4: $175k
- Home & Garden: Q1: $80k, Q2: $95k, Q3: $110k, Q4: $125k
:::note Desktop
I'll help you analyze your quarterly sales data with three different visualizations to address each of your questions. Let me create these visualizations for you.
First, let's visualize the hierarchical breakdown of your revenue across product categories:
I've created three comprehensive visualizations to help you understand your quarterly sales data from different perspectives:
The treemap visualization shows your revenue hierarchy with proportional areas representing the relative size of each category and quarter. Key insights:
The radar chart displays how all three product categories performed across the four quarters, making it easy to compare:
The Sankey diagram represents customer flow through your sales process, with flow thickness proportional to revenue:
Would you like me to create additional visualizations or dive deeper into any specific aspect of your sales data? :::
Visualization not appearing: Ensure the Auto Visualiser extension is enabled and your data follows the expected format.
Visualization opens but does not fit well inline: Try fullscreen mode in goose Desktop for more space.
Data format errors: Check that your data structure matches the required schema for the visualization type. The extension provides detailed error messages to guide you.
Performance with large datasets: For very large datasets, consider aggregating or sampling your data before visualization.