Skip to main content
This page lists the tools available from the production Grunt MCP Server. Tool names use snake case, such as bar_chart. Your MCP client retrieves each tool’s current input schema when it connects. Use that schema for the complete set of fields and supported values.

​
Chart tools

Each chart tool accepts a chart definition and an optional assetId:
  • Omit assetId to create an asset.
  • Include assetId to update the existing asset.
  • Pass rules and annotations as part of the chart definition.
Create a new asset when you change the core chart family, orientation, or arrangement. Do not reuse the existing assetId for that change.

​
Table tools

The table tool supports formatting, conditional rules, merged cells, row and column sizing, icons, gauges, shapes, flags, images, logos, and in-cell charts. Include an assetId to update an existing table. Use search_visual_assets before adding built-in icons or flags. It accepts a query, an asset type of all, icon, or flag, and a result limit from 1 to 50.

​
Asset tools

Use inspect_object before an exact update when you need the current data values, indexes, settings, or rule configuration.

​
Common response fields

Chart and table creation or update tools return:
  • structuredContent.assetId
  • structuredContent.assetCommit
  • structuredContent.exportGuideUrl
  • structuredContent.warnings (when present)
They also return a PNG preview of the rendered asset. fetch_latest_asset returns the current assetId, assetCommit, exportGuideUrl, and preview. inspect_object returns the inspected components and, when available, workbook data. get_project_changes returns a structured description of changes since the supplied assetCommit.

​
Input validation rules

  • Tool schemas reject unknown properties
  • Typed settings must use a supported discriminator, such as annotationType, ruleType, or axisType
  • Invalid schemas return MCP tool errors