# dashboardbase

> dashboardbase is a free MCP server for developer tools. Check dashboardbase widget responses and setup files against the live contract. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://www.dashboardbase.com
- **Repository:** https://github.com/dashboardbase/mcp
- **MCP Registry name:** com.dashboardbase/mcp
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-15

## About

This is the validation companion to dashboardbase, a service that renders dashboards from read-only JSON endpoints in your own backend. Instead of deploying an endpoint and discovering in the app that a widget errors, an agent can check the JSON first and fix problems before you open anything.

It offers three tools. One checks a whole setup file (the JSON that provisions a dashboard's widgets and datasources) and reports errors and warnings with field, line and column. One checks the body an endpoint returns against the widget contract and lists each path and message. The third uploads a finished setup file and returns a link to its import preview, only when asked, and refuses files carrying credentials.

The server holds no schemas of its own; it calls dashboardbase's public tools API, so improved messages arrive without an update, while new tools need a package update. No account or key is needed. Node.js 20 or later is required for the npx routes, and a self-contained .mcpb bundle exists for Claude Desktop.

## Features

- **Setup file validation:** Reports errors and warnings with field, line and column.
- **Widget response checks:** Flags the path and message for each mismatch with the widget contract.
- **Import preview link:** Uploads a finished setup file and returns a link that opens its import preview.
- **Credential refusal:** Rejects setup files containing credentials and names the offending fields.
- **No account needed:** Calls the public tools API with no key or configuration.
- **Many clients:** Install steps for Claude Code, Claude Desktop, Cursor, Windsurf, VS Code and Codex CLI.

## Good for

- Validate an endpoint an agent just wrote before deploying
- Lint a dashboard setup file
- Get a shareable import preview of a dashboard
- Catch typos such as unknown widget types

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dashboardbase/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `validate_setup_file`: Check a dashboardbase setup file and report errors and warnings with field, line and column.
- `validate_widget_response`: Check a widget endpoint's JSON body against the widget contract.
- `create_setup_link`: Upload a finished setup file and return a link to its import preview.

## FAQ

### Do I need an account or API key?

No. The validation API is public, so nothing needs configuring.

### How do I install it?

Run claude mcp add dashboardbase -- npx -y @dashboardbase/mcp, or use the equivalent JSON or TOML config for other clients.

### What does it require?

Node.js 20 or newer for the npx routes; the Claude Desktop .mcpb bundle needs no Node.

### When do new tools show up?

After the package updates and your client restarts the server; better error messages arrive automatically.

### Is dashboardbase free?

Yes. dashboardbase is free to use.

### How do I add dashboardbase to Claude Code?

Run this command in your terminal: claude mcp add mcp -- npx -y @dashboardbase/mcp

### What are the best alternatives to dashboardbase?

The closest alternatives to dashboardbase are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/dashboardbase
