dashboardbase MCP server

dashboardbase MCP

Stop guessing whether your dashboard JSON is right. Ask.

This is the official MCP server for dashboardbase. Add it to your AI tool and it can check a widget endpoint's response — or a whole dashboard setup file — against the contract dashboardbase actually enforces, before you ever open the app.

The dashboardbase skill teaches your agent the JSON contract. This MCP lets it check its own work. Use both: the skill gets the shape right, the MCP proves it.

What this MCP does

It gives your agent two tools:

Both call the public dashboardbase validation API. No account, no API key, nothing to configure.

Before / after

Without it — your agent writes an endpoint, you deploy it, you wire it into dashboardbase, the widget shows an error, you go read the docs, you fix it, you deploy again.

With it — your agent writes the endpoint, validates the response, fixes the two things that were wrong, and hands you something that renders the first time.

Invalid setup file — 2 errors, 1 warning

  mappings[0].type  14:9  Unknown widget type "guage"
  mappings[1].path  22:5  Path must start with "/"

  warning  mappings[2]  No refreshInterval set

Install

Claude Code

claude mcp add dashboardbase -- npx -y @dashboardbase/mcp

One click

Claude Desktop

Download dashboardbase-mcp.mcpb from the latest release and drag it into Claude Desktop's extensions settings. The bundle is self-contained — you don't even need Node.

Cursor, Windsurf, and most other clients

These use the mcpServers shape. Add it to ~/.cursor/mcp.json (Cursor), ~/.codeium/windsurf/mcp_config.json (Windsurf), or your client's equivalent:

{
  "mcpServers": {
    "dashboardbase": {
      "command": "npx",
      "args": ["-y", "@dashboardbase/mcp"]
    }
  }
}

VS Code

Shortened. The full README is on GitHub.