dashboard_id. Put reports on it with add_dashboard_reports.
If your client does not list this tool, it is not available on your connection: the connection is read-only, or your role in the Space is Viewer (or no longer allows changes).
When to use
- “Build me a paid social dashboard.”
- “Make a dashboard for the SEO team.”
add_dashboard_reports with the dashboard’s ID from list_dashboards.
Parameters
Example response
where_to_find_it on to the user. In Cometly, the dashboard is in the dashboard dropdown at the top left of Dashboard (see Customize your dashboards).
Limits
- One name per dashboard. A name already used by a dashboard in the Space is refused with a
validation_error. Names are compared without regard to case or surrounding spaces. The message gives that dashboard’sdashboard_id, so the agent can add reports to it or ask for another name. A retried call is therefore harmless: it finds the dashboard the first call created. - 50 dashboards per Space. No dashboard is created once the Space has 50.
- 10 an hour. One person creates at most 10 dashboards an hour in a Space this way, across all of their connections: a second connection does not add to the limit. After that the tool returns
rate_limited, and the message says when the count starts over. - One at a time per Space. If another dashboard is being created in the same Space at that moment, the call may return
rate_limitedand create nothing. Calllist_dashboardsbefore retrying: the dashboard may already be there.
Caveats
- Not available to read-only connections, which include every connection made by a Viewer: the tool is hidden and calling it returns “Tool not found”.
- The call changes your Cometly data only. It makes no outbound request, touches no ad platform and uses no AI credits.
- Renaming or deleting a dashboard, and moving or resizing its tiles, are not possible through MCP. Do those in Cometly.