Netdata

Name: Netdata
Author: netdata

by netdataversion 2.12.3i★ –iRuns in the cloud

Registry nameio.github.netdata/mcp-server

Install

Overview

Description from the maker (original English)

Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi2 of 3 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs in the cloud
Transport: Streamable HTTP
Category: Developer tools
You need to fill in: Authorization

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 2 of 3 passed
Runs on the maker’s server: what you ask it goes through their server.
You fill in yourself: Authorization

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Run this in your terminal

claude mcp add --transport http netdata https://app.netdata.cloud/api/v1/mcp --header 'Authorization: Bearer {NETDATA_CLOUD_API_TOKEN}'

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "netdata": {
      "url": "https://app.netdata.cloud/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer {NETDATA_CLOUD_API_TOKEN}"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "netdata": {
      "type": "http",
      "url": "https://app.netdata.cloud/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer {NETDATA_CLOUD_API_TOKEN}"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

Authorization secret required HTTP header
Netdata Cloud API token with scope:mcp

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account netdata, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
✓ Pass
Endpoint responds
Responded in 92 ms (HTTP 401)
! Caution
Sign-in with OAuth
Needs a key or token that you copy and paste yourself
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Developer toolsi

More stars than 0% of the other 1389 servers in this category
Published to the registry more recently than 95% of the other 1389 servers in this category
Basic checks equal to or better than 24% of the other 1389 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Netdata safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: Authorization

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (2.12.3) reached the registry 2 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: GitHub, Desktop Commander, Cloudflare MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitHub

by github

GitHub’s official server lets AI read and manage code, issues and pull requests in your account. Use GitHub’s hosted version or run it locally with Docker.

Computer or cloud★ 34,245MITUpdated 3 days ago

Install

Desktop Commander

by wonderwhy-er

MCP server for terminal commands, file operations, and process management

Runs on your computer★ 10,225MITUpdated 15 days ago

Install

Cloudflare MCP

by cloudflare

Cloudflare MCP servers

Runs in the cloud★ 4,446Apache-2.0Updated 14 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Netdata MCP

All Netdata Agents and Parents (v2.6.0+) are Model Context Protocol (MCP) servers, enabling AI assistants to interact with your infrastructure monitoring data.

Every Netdata Agent and Parent includes an MCP server, listening at same port the dashboard is listening at (default: 19999).

Netdata provides comprehensive access to all available observability data through MCP, including complete metadata:

Node Discovery - Hardware specifications, operating system details, version information, streaming topology, and associated metadata
Metrics Discovery - Full-text search capabilities across contexts, instances, dimensions, and labels
Function Discovery - Access to system functions including processes, network-connections, streaming, systemd-journal, windows-events, etc.
Alert Discovery - Real-time visibility into active and raised alerts
Metrics Queries - Complex aggregations and groupings with ML-powered anomaly detection
Metrics Scoring - Root cause analysis leveraging anomaly detection and metric correlations
Alert History - Complete alert transition logs and state changes
Function Execution - Execute Netdata functions on any connected node (requires Netdata Parent)
Log Exploration - Access logs from any connected node (requires Netdata Parent)

For sensitive features currently protected by Netdata Cloud SSO, a temporary MCP API key is generated on each Netdata instance. When presented via the Authorization: Bearer header, this key unlocks access to sensitive data and protected functions (like systemd-journal, windows-events and processes). This temporary API key mechanism will eventually be replaced with a new authentication system integrated with Netdata Cloud.

AI assistants have different visibility depending on where they connect:

Netdata Cloud: (coming soon) Full visibility across all nodes in your infrastructure
Netdata Parent Node: Visibility across all child nodes connected to that parent
Netdata Child/Standalone Node: Visibility only into that specific node

Transport Options

Netdata implements the MCP protocol with multiple transport options:

Transport	Endpoint	Use Case	Version Requirement
WebSocket	`ws://YOUR_IP:19999/mcp`	Original transport, requires nd-mcp bridge for stdio clients	v2.6.0+
HTTP Streamable	`http://YOUR_IP:19999/mcp`	Direct connection from AI clients supporting HTTP	v2.7.2+
SSE	`http://YOUR_IP:19999/sse`	Server-Sent Events for real-time streaming	v2.7.2+

Direct Connection (v2.7.2+): AI clients that support HTTP or SSE transports can connect directly to Netdata
Bridge Required: AI clients that only support stdio need the nd-mcp (stdio-to-websocket) or mcp-remote (stdio-to-http or stdio-to-sse) bridge

Official MCP Remote Client (mcp-remote)

If your AI client doesn't support HTTP/SSE directly and you don't want to use nd-mcp, you can use the official MCP remote client (requires Netdata v2.7.2+):

# Export your MCP key once per shell

export NETDATA_MCP_API_KEY="$(cat /var/lib/netdata/mcp_dev_preview_api_key)"

For HTTP transport

npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer $NETDATA_MCP_API_KEY"

For SSE transport

npx mcp-remote@latest --sse http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer $NETDATA_MCP_API_KEY"

Note: The --allow-http flag is required for non-HTTPS connections. Only use this on trusted networks as traffic will not be encrypted.

Finding the nd-mcp Bridge

Note: With the new HTTP and SSE transports, many AI clients can now connect directly to Netdata without nd-mcp. Check your AI client's documentation to see if it supports direct HTTP or SSE connections.

The nd-mcp bridge is only needed for AI clients that:

Only support stdio communication (like some desktop applications)
Cannot use HTTP or SSE transports directly
Cannot use npx mcp-remote@latest

The nd-mcp bridge needs to be available on your desktop or laptop where your AI client runs. Since most users run Netdata on remote servers rather than their local machines, you have two options:

If you have Netdata installed locally - Use the existing nd-mcp
If Netdata is only on remote servers - Build nd-mcp on your desktop/laptop

Option 1: Using Existing nd-mcp

If you have Netdata installed on your desktop/laptop, find the existing bridge:

Linux

# Try these locations in order:

which nd-mcp ls -la /usr/sbin/nd-mcp ls -la /usr/bin/nd-mcp ls -la /opt/netdata/usr/bin/nd-mcp ls -la /usr/local/bin/nd-mcp ls -la /usr/local/netdata/usr/bin/nd-mcp

Or search for it:

find / -name "nd-mcp" 2>/dev/null

Common locations:

Native packages (apt, yum, etc.): /usr/sbin/nd-mcp or /usr/bin/nd-mcp
Static installations: /opt/netdata/usr/bin/nd-mcp
Built from source: /usr/local/netdata/usr/bin/nd-mcp

macOS

# Try these locations:

which nd-mcp ls -la /usr/local/bin/nd-mcp ls -la /usr/local/netdata/usr/bin/nd-mcp ls -la /opt/homebrew/bin/nd-mcp

Or search for it:

find / -name "nd-mcp" 2>/dev/null

Windows

# Check common locations:

dir "C:\Program Files\Netdata\usr\bin\nd-mcp.exe" dir "C:\Netdata\usr\bin\nd-mcp.exe"

Or search for it:

where nd-mcp.exe

Option 2: Building nd-mcp for Your Desktop

If you don't have Netdata installed loca you can build just the nd-mcp bridge. Netdata provides three implementations - choose the one that best fits your environment:

Go bridge (recommended) - Go bridge source code

Produces a single binary with no dependencies
Creates executable named nd-mcp (nd-mcp.exe on windows)
Includes both build.sh and build.bat (for Windows)

Node.js bridge - Node.js bridge source code

Good if you already have Node.js installed
Creates script named nd-mcp.js
Includes build.sh

Python bridge - Python bridge source code

Good if you already have Python installed
Creates script named nd-mcp.py
Includes build.sh

To build:

# Clone the Netdata repository

git clone https://github.com/netdata/netdata.git cd netdata

Choose your preferred implementation

cd src/web/mcp/bridges/stdio-golang/ # or stdio-nodejs/ or stdio-python/

Build the bridge

./build.sh # On Windows with the Go version, use build.bat

The executable will be created with different names:

- Go: nd-mcp

- Node.js: nd-mcp.js

- Python: nd-mcp.py

Test the bridge with your Netdata instance (replace localhost with your Netdata IP)

./nd-mcp ws://localhost:19999/mcp # Go bridge ./nd-mcp.js ws://localhost:19999/mcp # Node.js bridge ./nd-mcp.py ws://localhost:19999/mcp # Python bridge

You should see:

nd-mcp: Connecting to ws://localhost:19999/mcp...

nd-mcp: Connected

Press Ctrl+C to stop the test

Get the absolute path for your AI client configuration

pwd # Shows current directory

Example output: /home/user/netdata/src/web/mcp/bridges/stdio-golang

Your nd-mcp path would be: /home/user/netdata/src/web/mcp/bridges/stdio-golang/nd-mcp

Important: When configuring your AI client, use the full absolute path to the executable:

Go bridge: /path/to/bridges/stdio-golang/nd-mcp
Node.js bridge: /path/to/bridges/stdio-nodejs/nd-mcp.js
Python bridge: /path/to/bridges/stdio-python/nd-mcp.py

Verify the Bridge Works

Once you have nd-mcp (either from existing installation or built), test it:

# Test connection to your Netdata instance (replace YOUR_NETDATA_IP with actual IP)

/path/to/nd-mcp ws://YOUR_NETDATA_IP:19999/mcp

You should see:

nd-mcp: Connecting to ws://YOUR_NETDATA_IP:19999/mcp...

nd-mcp: Connected

Press Ctrl+C to stop the test

Using MCP Remote Client

The official MCP remote client (mcp-remote) is an alternative bridge that enables stdio-only AI clients to connect to Netdata's HTTP and SSE transports (requires Netdata v2.7.2+). Unlike nd-mcp which only supports WebSocket, mcp-remote provides broader transport compatibility.

When to Use MCP Remote

Use mcp-remote when:

Your AI client only supports stdio communication
You want to use HTTP or SSE transports instead of WebSocket
You're running Netdata v2.7.2 or later
You don't want to build/install nd-mcp

Installation

No installation required - mcp-remote runs via npx:

# Test the connection

npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer YOUR_API_KEY"

Transport Options

mcp-remote supports multiple transport strategies:

# HTTP transport (recommended)

npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer YOUR_API_KEY"

SSE transport

npx mcp-remote@latest --sse http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer YOUR_API_KEY"

Auto-detect with fallback (tries SSE first, falls back to HTTP)

npx mcp-remote@latest --transport sse-first http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer YOUR_API_KEY"

HTTPS (no --allow-http flag needed)

npx mcp-remote@latest --http https://YOUR_NETDATA_IP:19999/mcp \ --header "Authorization: Bearer YOUR_API_KEY"

Common Options

Option	Description	Example
`--http`	Use HTTP transport	`--http http://host:19999/mcp`
`--sse`	Use SSE transport	`--sse http://host:19999/mcp`
`--allow-http`	Allow non-HTTPS connections (required for HTTP URLs)	`--allow-http`
`--header`	Add custom headers (for authentication)	`--header "Authorization: Bearer KEY"`
`--transport`	Transport strategy	`--transport sse-first` (tries SSE, falls back to HTTP)
`--debug`	Enable debug logging	`--debug`
`--host`	OAuth callback host (default: localhost)	`--host 127.0.0.1`
Port number	OAuth callback port (optional)	`9696`

Authentication

For Netdata MCP, pass the API key via the Authorization header:

# Using environment variable (recommended)

export NETDATA_MCP_API_KEY="$(cat /var/lib/netdata/mcp_dev_preview_api_key)"

npx mcp-remote@latest --http http://YOUR_NETDATA_IP:19999/mcp \ --allow-http \ --header "Authorization: Bearer $NETDATA_MCP_API_KEY"

Security Note: The --allow-http flag is required for non-HTTPS connections. Only use this on trusted networks as traffic will not be encrypted.

Troubleshooting

Connection Issues:

# Enable debug logging

npx mcp-remote@latest --debug --http http

Only the beginning is shown; read the rest in the repo

Netdata

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Developer toolsi

Common questions

Alternatives

GitHub

Desktop Commander

Cloudflare MCP

README from the maker

Netdata MCP

Transport Options

Official MCP Remote Client (mcp-remote)

For HTTP transport

For SSE transport

Finding the nd-mcp Bridge

Option 1: Using Existing nd-mcp

Linux

Or search for it:

macOS

Or search for it:

Windows

Or search for it:

Option 2: Building nd-mcp for Your Desktop

Choose your preferred implementation

Build the bridge

The executable will be created with different names:

- Go: nd-mcp

- Node.js: nd-mcp.js

- Python: nd-mcp.py

Test the bridge with your Netdata instance (replace localhost with your Netdata IP)

You should see:

nd-mcp: Connecting to ws://localhost:19999/mcp...

nd-mcp: Connected

Press Ctrl+C to stop the test

Get the absolute path for your AI client configuration

Example output: /home/user/netdata/src/web/mcp/bridges/stdio-golang

Your nd-mcp path would be: /home/user/netdata/src/web/mcp/bridges/stdio-golang/nd-mcp

Verify the Bridge Works

You should see:

nd-mcp: Connecting to ws://YOUR_NETDATA_IP:19999/mcp...

nd-mcp: Connected

Press Ctrl+C to stop the test

Using MCP Remote Client

When to Use MCP Remote

Installation

Transport Options

SSE transport

Auto-detect with fallback (tries SSE first, falls back to HTTP)

HTTPS (no --allow-http flag needed)

Common Options

Authentication

Troubleshooting