Skip to main content
The Grunt MCP Server exposes chart creation and asset editing tools over Model Context Protocol (MCP). You can use it to let an AI client:
  • Create charts from structured data
  • Update chart rules and annotations
  • Fetch latest asset state and project diffs
  • Return chart previews and export links

Endpoint and transport

  • Transport: streamable HTTP (stateless)
  • MCP endpoint path: /mcp
  • Local default URL: http://localhost:5044/mcp
  • Production example URL: https://mcp.grunt.io/mcp
Use any MCP client that supports streamable HTTP + JSON-RPC tool calls.

Core capabilities

Create charts

Create bar, line, area, waterfall, pie/donut, scatter/bubble, mekko, dumbbell, and combined charts.

Modify existing assets

Update chart rules and annotations on existing assetId values.

Track changes

Fetch latest project state and compare a commit to the newest commit.

Integrate securely

Use JWT auth in non-development environments with OAuth metadata discovery.

Next steps

Connect and authenticate

Configure your client, endpoint, and auth flow.

Tool reference

See public tools, private tools, and not-yet-implemented tools.

Development

Run locally, configure environment values, and verify endpoints.