# OtlpDashboard

> OtlpDashboard is an open-source MCP server for developer tools. Let an AI client query logs, traces and metrics stored in a self-hosted OTLP dashboard. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, API
- **Website:** https://adiakys.github.io/OtlpDashboard/
- **Repository:** https://github.com/adiakys/otlpdashboard
- **MCP Registry name:** io.github.Adiakys/otlpdashboard
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

The MCP endpoint is a switch inside a larger product: OtlpDashboard is a .NET 10 and EF Core backend with a Vue 3 / Nuxt 4 front end that receives OTLP over gRPC on port 4317 and HTTP/Protobuf on 4318. The same port 4318 serves the web app and, once `Dashboard__Mcp__Enabled` is true, the `/mcp` route that Claude Code or another MCP client can call.

Telemetry lands in SQLite by default, with PostgreSQL or SQL Server as one-setting alternatives, and a background sweep drops old rows per signal on a retention schedule you choose. Because the assistant reads the same store as the browser UI, it sees the trace-linked logs, the per-service metrics and the service map the dashboard builds from spans.

Access is opt-in. Setting `DASHBOARD__BROWSERTOKEN` makes the web app, read API and MCP endpoint demand a bearer token; leaving it empty keeps everything open, which the health check reports as degraded. A separate API key protects ingestion.

## Features

- **OTLP receiver and viewer:** Accepts traces, logs and metrics over gRPC and HTTP/Protobuf and shows them in one browser UI.
- **Trace waterfall:** Filter by application, duration, status and attributes, then open a span tree, flame view and the logs sharing the trace ID.
- **Service map:** Draws calls between services, databases and caches from span data with request counts.
- **Custom dashboards:** Place stat, line, gauge, heatmap, trace and log widgets on a 12-column grid, or install widget packs from Git.
- **Choice of database:** Stores data in SQLite, PostgreSQL or SQL Server with per-signal retention.
- **Bearer-token gating:** Separate tokens protect the web app, read API and MCP endpoint, and OTLP ingestion.

## Good for

- Ask Claude Code why error logs spiked after a deploy
- Look up the trace behind a slow request from an AI client
- Check metrics per service and instance without opening the UI
- Keep telemetry for a small team across container restarts
- Replace the Aspire dashboard where data must survive restarts

## Install

### Claude Code (Terminal)

```sh
claude mcp add otlpdashboard --env Dashboard__Mcp__Enabled='<Dashboard__Mcp__Enabled>' --env DASHBOARD__BROWSERTOKEN='<DASHBOARD__BROWSERTOKEN>' -- docker run -i --rm -e Dashboard__Mcp__Enabled -e DASHBOARD__BROWSERTOKEN ghcr.io/adiakys/otlpdashboard:26.11
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "otlpdashboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "Dashboard__Mcp__Enabled",
        "-e",
        "DASHBOARD__BROWSERTOKEN",
        "ghcr.io/adiakys/otlpdashboard:26.11"
      ],
      "env": {
        "Dashboard__Mcp__Enabled": "<Dashboard__Mcp__Enabled>",
        "DASHBOARD__BROWSERTOKEN": "<DASHBOARD__BROWSERTOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "otlpdashboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "Dashboard__Mcp__Enabled",
        "-e",
        "DASHBOARD__BROWSERTOKEN",
        "ghcr.io/adiakys/otlpdashboard:26.11"
      ],
      "env": {
        "Dashboard__Mcp__Enabled": "<Dashboard__Mcp__Enabled>",
        "DASHBOARD__BROWSERTOKEN": "<DASHBOARD__BROWSERTOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "otlpdashboard": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "Dashboard__Mcp__Enabled",
        "-e",
        "DASHBOARD__BROWSERTOKEN",
        "ghcr.io/adiakys/otlpdashboard:26.11"
      ],
      "env": {
        "Dashboard__Mcp__Enabled": "<Dashboard__Mcp__Enabled>",
        "DASHBOARD__BROWSERTOKEN": "<DASHBOARD__BROWSERTOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "otlpdashboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "Dashboard__Mcp__Enabled",
        "-e",
        "DASHBOARD__BROWSERTOKEN",
        "ghcr.io/adiakys/otlpdashboard:26.11"
      ],
      "env": {
        "Dashboard__Mcp__Enabled": "<Dashboard__Mcp__Enabled>",
        "DASHBOARD__BROWSERTOKEN": "<DASHBOARD__BROWSERTOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "otlpdashboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "Dashboard__Mcp__Enabled",
        "-e",
        "DASHBOARD__BROWSERTOKEN",
        "ghcr.io/adiakys/otlpdashboard:26.11"
      ],
      "env": {
        "Dashboard__Mcp__Enabled": "<Dashboard__Mcp__Enabled>",
        "DASHBOARD__BROWSERTOKEN": "<DASHBOARD__BROWSERTOKEN>"
      }
    }
  }
}
```

## FAQ

### Does it support alerting?

No. The project's own comparison says alerting is not included, unlike a Grafana stack.

### How do I turn the MCP endpoint on?

Set the environment variable Dashboard__Mcp__Enabled to true; it mounts the server at /mcp on port 4318.

### How is the endpoint protected?

Set DASHBOARD__BROWSERTOKEN and send it as a bearer token. If it is empty, the endpoint is open.

### Which databases can it use?

SQLite out of the box, with PostgreSQL or SQL Server selectable through configuration.

### Is OtlpDashboard free?

Yes. OtlpDashboard is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add otlpdashboard --env Dashboard__Mcp__Enabled='<Dashboard__Mcp__Enabled>' --env DASHBOARD__BROWSERTOKEN='<DASHBOARD__BROWSERTOKEN>' -- docker run -i --rm -e Dashboard__Mcp__Enabled -e DASHBOARD__BROWSERTOKEN ghcr.io/adiakys/otlpdashboard:26.11

### What are the best alternatives to OtlpDashboard?

The closest alternatives to OtlpDashboard 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.
- [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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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