Use the Speak AI MCP server tool create_dashboard to create an analytics
dashboard.
What does it do?
Create an analytics dashboard. Only title is required: source defaults to the
whole workspace and dateRange to last30days. Add widgets by listing their types (the
MCP assigns ids and lays them out automatically), scope with source
({type:“folders”,folderIds} | {type:“team”} | {type:“workspace”}) and
dateRange ({preset}), and optionally group widgets into sections. Design guidance:
lead with a narrative widget as the first widget; group sections by the QUESTION
they answer, not by widget type; don’t pad. Every widget earns its place (aim for
4-16 widgets on a full build); if something can’t be expressed by the widget
catalog, put it in a narrative widget’s focus instead of faking it. Call
list_dashboard_widgets first for the widget catalog, config vocabulary, design
rules, and full examples.
Parameters
create_dashboard takes 10 parameters, 1 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
title |
string | Yes | Dashboard name, max 60 chars (the only required field) |
description |
string | No | Dashboard description, max 280 chars |
source |
object | No | Data source: {type:“folders”, folderIds:[…]} | {type:“team”} | {type:“workspace”} |
dateRange |
object | No | Date range: strict preset only, no free-form start/end dates |
sections |
array of object | No | Optional named widget groups (tabs). Each references widgets by their explicit ids; widgets in no section form the implicit Overview group. |
widgets |
array of object | No | Widgets to place on the dashboard, in order (max 24). The MCP assigns ids and computes a tidy two-per-row grid layout matching the Speak UI unless you pass explicit id/layout. |
icon |
string | No | Icon identifier |
assignTo |
array of string | No | User ids, or group ids in the “<groupId> (G)” convention, to share view access with |
filters |
object | No | Field filters. filters.filterList is an array of { fieldName, fieldOperator?, fieldValue?: string[], fieldCondition? }. Other keys pass through but only filterList is enforced. |
isDefault |
boolean | No | Make this the company default dashboard |
Behaviour
The Speak AI MCP server publishes these behaviour hints for create_dashboard.
- Can change data in your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call can have an extra effect.
- Stays inside Speak AI. Does not reach other systems.
Related
- Dashboards lists the rest of the Dashboards category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.