diff --git a/crates/goose-cli/src/commands/configure.rs b/crates/goose-cli/src/commands/configure.rs index bcee3d2309e3..52212dee5a34 100644 --- a/crates/goose-cli/src/commands/configure.rs +++ b/crates/goose-cli/src/commands/configure.rs @@ -750,8 +750,8 @@ pub fn configure_extensions_dialog() -> Result<(), Box> { let extension = cliclack::select("Which built-in extension would you like to enable?") .item( "autovisualiser", - "Auto Visualizer", - "Data visualization and UI generation tools", + "Auto Visualiser", + "Data visualisation and UI generation tools", ) .item( "computercontroller", diff --git a/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/autovis-banner.png b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/autovis-banner.png new file mode 100644 index 000000000000..2fbe4093ca62 Binary files /dev/null and b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/autovis-banner.png differ diff --git a/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/index.md b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/index.md new file mode 100644 index 000000000000..51c9609a96ac --- /dev/null +++ b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/index.md @@ -0,0 +1,66 @@ +--- +title: "Auto Visualiser with MCP-UI" +description: "Automatically show renders visual representations of data as you interact with it, powered by MCP-UI" +authors: + - mic +--- + +![blog banner](autovis-banner.png) + +Data visualization just got a major upgrade in Goose. With the new MCP-UI auto visualiser feature, you no longer need to manually request charts, graphs, or visual representations of your data. Goose now automatically detects when data would benefit from visualization and renders interactive visual components directly in your conversation. + + + + +## What is Auto Visualiser? + +[Auto Visualiser](/docs/mcp/autovisualiser-mcp) is a built-in extension that integrates with [Goose's MCP-UI system](/docs/guides/interactive-chat/) to automatically generate visual representations of data as you work. + +![switch](switch.png) + +Once turned on, a smorgasboard of visualisation tools are made available as tools which will be automatically invoked if and when it makes sense to, for example, show things as a radar diagram, or a "sankey" diagram: + +![sankey](sankey.png) + +You can also explicitly ask for a visualisation, even specifying what style you want, and Goose will try to shape your data and then render it inline. This is powered by the [MCP-UI](https://mcpui.dev/) emerging standard, which lets the MCP server formulate a visualisation (in this case using libraries like d3.js) and render it inline. + +The autovisualiser analyzes data patterns and automatically suggests the most appropriate visualization type. My favourite is the treemap which is a great way to see relative sizes of things in a way that pie charts can mislead. It is also interactive in that you can drill down. + +![tree map](treemap.png) + + +Of course, if you want you can resort to the "last refuge of the unimaginative" and graph the weather: + +![weather](weather.png) + +Note this is an early feature, and functionality may change and vary a lot (as with MCP-UI). This is an early example of what is emerging as generative UI, although in this case the templates are pre-generated and the data is dynamically matched to the session and then displayed (from local resources). + + +## Types of Visualizations + +There are currently several families of things it can show: + +* sankey diagrams +* radar charts +* chord diagrams +* donut/pie charts +* bar graphs and general charts +* treemap visualisations (tiles) +* maps (place things on geographic maps) + +--- + +*Ready to see your data? [Enable the Auto Visualiser extension](/docs/mcp/autovisualiser-mcp#configuration) in Goose.* + + + + + + + + + + + + + diff --git a/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/sankey.png b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/sankey.png new file mode 100644 index 000000000000..88f20687077d Binary files /dev/null and b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/sankey.png differ diff --git a/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/switch.png b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/switch.png new file mode 100644 index 000000000000..c42426645fe7 Binary files /dev/null and b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/switch.png differ diff --git a/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/treemap.png b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/treemap.png new file mode 100644 index 000000000000..4f6ea776c60e Binary files /dev/null and b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/treemap.png differ diff --git a/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/weather.png b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/weather.png new file mode 100644 index 000000000000..fe0bf816bb95 Binary files /dev/null and b/documentation/blog/2025-08-27-autovisualiser-with-mcp-ui/weather.png differ diff --git a/documentation/docs/mcp/alby-mcp.md b/documentation/docs/mcp/alby-mcp.md index 42cbfc5219c0..6e8cea799168 100644 --- a/documentation/docs/mcp/alby-mcp.md +++ b/documentation/docs/mcp/alby-mcp.md @@ -1,5 +1,5 @@ --- -title: Alby Bitcoin Payments MCP +title: Alby Bitcoin Payments Extension description: Connect Goose to your Bitcoin Lightning Wallet --- diff --git a/documentation/docs/mcp/autovisualiser-mcp.md b/documentation/docs/mcp/autovisualiser-mcp.md new file mode 100644 index 000000000000..ae2d447c1a9e --- /dev/null +++ b/documentation/docs/mcp/autovisualiser-mcp.md @@ -0,0 +1,159 @@ +--- +title: Auto Visualiser Extension +description: Add automatic data visualization to Goose +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import GooseBuiltinInstaller from '@site/src/components/GooseBuiltinInstaller'; +import ImageCarousel from '@site/src/components/ImageCarousel'; + +The Auto Visualiser extension enables Goose to automatically generate interactive data visualizations directly in your conversation. This built-in extension leverages MCP-UI to create charts, graphs, maps, and other visual representations of your data without requiring manual requests. + +This guide will cover enabling and using the Auto Visualiser MCP Server. + +## Configuration + + + + + + + + + 1. Run the `configure` command: + ```sh + goose configure + ``` + + 2. Choose to `Toggle Extensions` + ```sh + ┌ 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 + ``` + + + + +## Visualization Types + +The Auto Visualiser is a powerful extension that integrates with Goose's MCP-UI system to automatically detect when data would benefit from visualization and render interactive visual components. It analyzes data patterns in your conversations and suggests the most appropriate visualization type. + +| 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) | +| **Line/Bar/Scatter Charts** | Traditional chart types for data analysis | Time series data
(historical data, trends over time) | + +### Example Visualizations + + + +### Features + +- **Automatic Detection**: Goose intelligently chooses the best visualization type for your data +- **Interactive Components**: All visualizations are interactive with hover effects, zooming, and drilling capabilities +- **MCP-UI Integration**: Leverages the emerging MCP-UI standard for seamless rendering +- **Multiple Chart Support**: Can render multiple visualizations in a single response +- **Customizable Styling**: Supports custom colors, labels, and formatting options +- **Export Capability**: Visualizations can be saved as HTML files for sharing + + +## Example Usage + +In this example, I'll have Goose analyze some sales data and automatically visualize it using the Auto Visualiser extension. + + +### Goose Prompt +``` +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 +``` + +### Goose Output + +:::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: + +![](/img/autovisualiser-treemap.png) + +![](/img/autovisualiser-radar.png) + +![](/img/autovisualiser-sankey.png) + + +I've created three comprehensive visualizations to help you understand your quarterly sales data from different perspectives: + +#### 1. Hierarchical Revenue Breakdown (Treemap) +The **treemap visualization** shows your revenue hierarchy with proportional areas representing the relative size of each category and quarter. Key insights: +- **Electronics** is your largest revenue generator ($745k total) +- **Clothing** follows as second largest ($595k total) +- **Home & Garden** is smallest but growing ($410k total) +- You can see how each quarter contributes within each category + +#### 2. Performance Metrics Comparison (Radar Chart) +The **radar chart** displays how all three product categories performed across the four quarters, making it easy to compare: +- **Electronics** shows strong Q3 performance ($220k) with slight Q4 decline +- **Clothing** demonstrates consistent growth throughout the year +- **Home & Garden** shows steady upward trajectory across all quarters +- All categories show their strongest performance in Q3-Q4 + +#### 3. Sales Funnel Flow (Sankey Diagram) +The **Sankey diagram** represents customer flow through your sales process, with flow thickness proportional to revenue: +- Shows how market opportunities flow into prospects for each category +- Demonstrates the conversion from prospects to actual sales +- **Electronics** has the thickest flow (highest revenue conversion) +- **Home & Garden** has the thinnest but represents growth opportunity + +#### Key Business Insights: +- **Total Revenue**: $1.75M across all categories +- **Growth Pattern**: All categories show positive growth trends +- **Category Performance**: Electronics (42.6%), Clothing (34%), Home & Garden (23.4%) +- **Seasonal Trends**: Q3 appears to be your strongest quarter overall + +Would you like me to create additional visualizations or dive deeper into any specific aspect of your sales data? +::: + + + +## Troubleshooting + +- **Visualization not appearing**: Ensure the Auto Visualiser extension is enabled and your data follows the expected format. + +- **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. + diff --git a/documentation/docs/mcp/cloudflare-mcp.md b/documentation/docs/mcp/cloudflare-mcp.md index 5e05d9482d0a..091b3273540b 100644 --- a/documentation/docs/mcp/cloudflare-mcp.md +++ b/documentation/docs/mcp/cloudflare-mcp.md @@ -1,5 +1,5 @@ --- -title: Cloudflare MCP Server +title: Cloudflare Extension description: Add Cloudflare MCP Servers as Goose Extensions unlisted: true --- diff --git a/documentation/docs/mcp/container-use-mcp.md b/documentation/docs/mcp/container-use-mcp.md index f096a584c35d..1b454d5ac3df 100644 --- a/documentation/docs/mcp/container-use-mcp.md +++ b/documentation/docs/mcp/container-use-mcp.md @@ -1,5 +1,5 @@ --- -title: Container Use +title: Container Use Extension description: Use Container-Use MCP as a Goose Extension --- diff --git a/documentation/static/img/autovisualiser-radar.png b/documentation/static/img/autovisualiser-radar.png new file mode 100644 index 000000000000..0669e55c0df0 Binary files /dev/null and b/documentation/static/img/autovisualiser-radar.png differ diff --git a/documentation/static/img/autovisualiser-sankey.png b/documentation/static/img/autovisualiser-sankey.png new file mode 100644 index 000000000000..3eb72ad68b25 Binary files /dev/null and b/documentation/static/img/autovisualiser-sankey.png differ diff --git a/documentation/static/img/autovisualiser-treemap.png b/documentation/static/img/autovisualiser-treemap.png new file mode 100644 index 000000000000..dde097dd179e Binary files /dev/null and b/documentation/static/img/autovisualiser-treemap.png differ diff --git a/documentation/static/servers.json b/documentation/static/servers.json index 8e62f8302360..e228493fc541 100644 --- a/documentation/static/servers.json +++ b/documentation/static/servers.json @@ -50,6 +50,17 @@ } ] }, + { + "id": "autovisualiser", + "name": "Auto Visualiser", + "description": "Automatic data visualisation via MCP-UI", + "command": "", + "link": "https://github.com/block/goose/tree/main/crates/goose-mcp/src/autovisualiser", + "installation_notes": "This is a built-in extension that comes with Goose and can be enabled on the Extensions page.", + "is_builtin": true, + "endorsed": true, + "environmentVariables": [] + }, { "id": "blender-mcp", "name": "Blender",