# Netdata MCP server

> Enables AI assistants to interact with real-time infrastructure monitoring data, including metrics, logs, alerts, and anomaly detection.

- Repository: https://github.com/netdata/netdata
- Page: https://hostedmcp.org/servers/netdata/mcp-server
- Transport: remote
- Stars: 81384
- License: GPL-3.0
- Latest version: 2.12.3

## Install

### Claude Code

```sh
claude mcp add --transport http mcp-server https://app.netdata.cloud/api/v1/mcp
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://app.netdata.cloud/api/v1/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://app.netdata.cloud/api/v1/mcp"
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server]
url = "https://app.netdata.cloud/api/v1/mcp"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "httpUrl": "https://app.netdata.cloud/api/v1/mcp"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `NETDATA_MCP_API_KEY` | no | no |  |

## FAQ

### What kind of data can the AI assistant access through Netdata MCP?

The assistant can access node discovery details, metrics discovery, system functions like processes and network connections, real-time alerts, and logs.

### How is authentication handled for sensitive features?

Sensitive features are protected by a temporary MCP API key generated on each Netdata instance, which must be presented via the Authorization: Bearer header.