Netdata

MCP serverMonitoring & ops

Netdata is an MCP server that connects an AI agent to live infrastructure monitoring. It lets the agent read real-time metrics, logs, alerts, and ML-based anomaly detection from your systems. Use it when you want the agent to check what is happening on your servers instead of guessing.

Use Netdata in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Netdata and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use Netdata

Details

Available today. Use it from your connected AI after setup.

Have a running Netdata instance that the agent can reach.

NetdataStart free

What your AI can do with it

  • Read live server metrics through Netdata MCP
  • Search and read logs from monitored systems
  • List active alerts and their current state
  • Surface ML-based anomaly detection results
  • Report on infrastructure health in real time

Getting started

  1. Have a running Netdata instance that the agent can reach.
  2. Install or add the Netdata MCP server to your agent setup.
  3. Configure the connection details for your Netdata instance.
  4. Restart or reload the agent so it picks up the new server.
  5. Ask the agent to list current alerts to confirm the connection works.

Install Netdata

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user netdata 'https://app.netdata.cloud/api/v1/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://app.netdata.cloud/api/v1/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=netdata&config=eyJ1cmwiOiJodHRwczovL2FwcC5uZXRkYXRhLmNsb3VkL2FwaS92MS9tY3AifQ==

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://app.netdata.cloud/api/v1/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add netdata --url 'https://app.netdata.cloud/api/v1/mcp'

    Run it once, then sign in with codex mcp login netdata if the server asks for an account.

From the project's README

As published by netdata/netdata in README.md.

MENU: WHO WE ARE | KEY FEATURES | GETTING STARTED | HOW IT WORKS | FAQ | DOCS | COMMUNITY | CONTRIBUTE | LICENSE

[!WARNING] People get addicted to Netdata. Once you use it on your systems, there's no going back.


WHO WE ARE

Netdata is an open-source, real-time infrastructure monitoring platform. Monitor, detect, and act across your entire infrastructure.

Core Advantages:

  • Instant Insights – With Netdata you can access per-second metrics and visualizations.
  • Zero Configuration – You can deploy immediately without complex setup.
  • ML-Powered – You can detect anomalies, predict issues, and automate analysis.
  • Efficient – You can monitor with minimal resource usage and maximum scalability.
  • Secure & Distributed – You can keep your data local with no central collection needed.

With Netdata, you get real-time, per-second updates. Clear insights at a glance, no complexity.

In 2013, at the company where Costa Tsaousis was COO, a significant percentage of their cloud-based transactions failed silently, severely impacting business performance.

Costa and his team tried every troubleshooting tool available at the time. None could identify the root cause. As Costa later wrote:

“I couldn’t believe that monitoring systems provide so few metrics and with such low resolution, scale so badly, and cost so much to run.”

Frustrated, he decided to build his own monitoring tool, starting from scratch.

That decision led to countless late nights and weekends. It also sparked a fundamental shift in how infrastructure monitoring and troubleshooting are approached, both in method and in cost.

Most Energy-Efficient Monitoring Tool

According to the University of Amsterdam study, Netdata is the most energy-efficient tool for monitoring Docker-based systems. The study also shows Netdata excels in CPU usage, RAM usage, and execution time compared to other monitoring solutions.


Key Features

FeatureDescriptionWhat Makes It Unique
Real-TimePer-second data collection and processingWorks in a beat – click and see results instantly
Zero-ConfigurationAutomatic detection and discoveryAuto-discovers everything on the nodes it runs
ML-PoweredUnsupervised anomaly detectionTrains multiple ML models per metric at the edge
Long-Term RetentionHigh-performance storage~0.5 bytes per sample with tiered storage for archiving
Advanced VisualizationRich, interactive dashboardsSlice and dice data without query language
Extreme ScalabilityNative horizontal scalingParent-Child centralization with multi-million samples/s
Complete VisibilityFrom infrastructure to applicationsSimplifies operations and eliminates silos
Edge-BasedProcessing at your premisesDistributes code instead of centralizing data

[!NOTE]
Want to put Netdata to the test against Prometheus? Explore the full comparison.


Netdata Ecosystem

This three-part architecture enables you to scale from single nodes to complex multi-cloud environments:

ComponentDescriptionLicense
Netdata Agent• Core monitoring engine• Handles collection, storage, ML, alerts, exports• Runs on servers, cloud, K8s, IoT• Zero production impactGPL v3+
Netdata Cloud• Enterprise features• User management, RBAC, horizontal scaling• Centralized alerts• Free community tier• No metric storage centralization
Netdata UI• Dashboards and visualizations• Free to use• Included in standard packages• Latest version via CDNNCUL1

What You Can Monitor

With Netdata you can monitor all these components across platforms:

ComponentLinuxFreeBSDmacOSWindows
System ResourcesCPU, Memory and system shared resourcesFullYesYesYes
StorageDisks, Mount points, Filesystems, RAID arraysFullYesYesYes
NetworkNetwork Interfaces, Protocols, Firewall, etcFullYesYesYes
Hardware & SensorsFans, Temperatures, Controllers, GPUs, etcFullSomeSomeSome
O/S ServicesResources, Performance and StatusYessystemd---
ProcessesResources, Performance, OOM, and moreYesYesYesYes
System and Application LogsYessystemd-journal--YesWindows Event Log, ETW
Network ConnectionsLive TCP and UDP sockets per PIDYes---
ContainersDocker/containerd, LXC/LXD, Kubernetes, etcYes---
VMs (from the host)KVM, qemu, libvirt, Proxmox, etcYescgroups--YesHyper-V
Synthetic ChecksTest APIs, TCP ports, Ping, Certificates, etcYesYesYesYes
Packaged Applicationsnginx, apache, postgres, redis, mongodb,and hundreds moreYesYesYesYes
Cloud Provider InfrastructureAWS, GCP, Azure, and moreYesYesYesYes
Custom ApplicationsOpenMetrics, StatsD and soon OpenTelemetryYesYesYesYes

On Linux, you can continuously monitor all kernel features and hardware sensors for errors, including Intel/AMD/Nvidia GPUs, PCI AER, RAM EDAC, IPMI, S.M.A.R.T, Intel RAPL, NVMe, fans, power supplies, and voltage readings.


Getting Started

You can install Netdata on all major operating systems. To begin:

1. Install Netdata

Choose your platform and follow the installation guide:

[!NOTE] You can access the Netdata UI at http://localhost:19999 (or http://NODE:19999 if remote).

2. Configure Collectors

Netdata auto-discovers most metrics, but you can manually configure some collectors:

3. Configure Alerts

You can use hundreds of built-in alerts and integrate with:

email, Slack, Telegram, PagerDuty, Discord, Microsoft Teams, and more.

[!NOTE]
Email alerts work by default if there's a configured MTA.

4. Configure Parents

You can centralize dashboards, alerts, and storage with Netdata Parents:

[!NOTE]
You can use Netdata Parents for central dashboards, longer retention, and alert configuration.

5. Connect to Netdata Cloud

Sign in to Netdata Cloud and connect your nodes for:

  • Access from anywhere
  • Horizontal scalability and multi-node dashboards
  • UI configuration for alerts and data collection
  • Role-based access control
  • Free tier available

[!NOTE]
Netdata Cloud is optional. Your data stays in your infrastructure.

Live Demo Sites


How It Works

With Netdata you can run a modular pipeline for metrics collection, processing, and visualization.

flowchart TB
  A[Netdata Agent]:::mainNode
  A1(Collect):::green --> A
  A2(Store):::green --> A
  A3(Learn):::green --> A
  A4(Detect):::green --> A
  A5(Check):::green --> A
  A6(Stream):::green --> A
  A7(Archive):::green --> A
  A8(Query):::green --> A
  A9(Score):::green --> A

  classDef green fill:#bbf3bb,stroke:#333,stroke-width:1px,color:#000
  classDef mainNode fill:#f0f0f0,stroke:#333,stroke-width:1px,color:#333

With each Agent you can:

  1. Collect – Gather metrics from systems, containers, apps, logs, APIs, and synthetic checks.
  2. Store – Save metrics to a high-efficiency, tiered time-series database.
  3. Learn – Train ML models per metric using recent behavior.
  4. Detect – Identify anomalies using trained ML models.
  5. Check – Evaluate metrics against pre-set or custom alert rules.
  6. Stream – Send metrics to Netdata Parents in real time.
  7. Archive – Export metrics to Prometheus, InfluxDB, OpenTSDB, Graphite, and others.
  8. Query – Access metrics via an API for dashboards or third-party tools.
  9. Score – Use a scoring engine to find patterns and correlations across metrics.

[!NOTE]
Learn more: Netdata's architecture

Agent Capabilities

With the Netdata Agent, you can use these core capabilities out-of-the-box:

CapabilityDescription
Comprehensive Collection• 800+ integrations• Systems, containers, VMs, hardware sensors• OpenMetrics, StatsD, and logs• OpenTelemetry support coming soon
Performance & Precision• Per-second collection• Real-time visualization with 1-second latency• High-resolution metrics
Edge-Based ML• ML models trained at the edge• Automatic anomaly detection per metric• Pattern recognition based on historical behavior
Advanced Log Management• Direct systemd-journald and Windows Event Log integration• Process logs at the edge• Rich log visualization
Observability Pipeline• Parent-Child relationships• Flexible centralization• Multi-level replication and retention
Automated Visualization• NIDL data model• Auto-generated dashboards• No query language needed
Smart Alerting• Pre-configured alerts• Multiple notification methods• Proactive detection
Low Maintenance• Auto-detection• Zero-touch ML• Easy scalability• CI/CD friendly
Open & Extensible• Modular architecture• Easy to customize• Integrates with existing tools

CNCF Membership


FAQ

Yes. Netdata follows OpenSSF best practices, has a security-first design, and is regularly audited by the community.

No. Even with ML and per-second metrics, Netdata uses minimal resources.

  • ~5% CPU and 150MiB RAM by default on production systems
  • <1% CPU and ~100MiB RAM when ML and alerts are disabled and using ephemeral storage
  • Parents scale to millions of metrics per second with appropriate hardware

You can use the Netdata Monitoring section in the dashboard to inspect its resource usage.

As much as your disk allows.

With Netdata you can use tiered retention:

  • Tier 0: per-second resolution
  • Tier 1: per-minute resolution
  • Tier 2: per-hour resolution

These are queried automatically based on the zoom level.

Yes. With Netdata you can:

  • Scale horizontally with many Agents
  • Scale vertically with powerful Parents
  • Scale infinitely via Netdata Cloud

You can use Netdata Cloud to merge many independent infrastructures into one logical view.

No. Netdata minimizes disk usage:

  • Metrics are flushed to disk every 17 minutes, spread out evenly
  • Uses direct I/O and compression (ZSTD)
  • Can run entirely in RAM or stream to a Parent

You can use alloc or ram mode for no disk writes.

With Netdata you get a complete monitoring solution—not just tools.

  • No manual setup or dashboards needed
  • Built-in ML, alerts, dashboards, and correlations
  • More efficient and easier to deploy

Performance comparison

With Netdata you can store all metrics on your infrastructure—no sampling, no aggregation, no loss.

  • High-resolution metrics by default
  • ML per metric, not shared models
  • Unlimited scalability without skyrocketing cost

Yes. You can use Netdata together with traditional tools.

With Netdata you get:

  • Real-time, high-resolution monitoring
  • Zero configuration and auto-generated dashboards
  • Anomaly detection and advanced visualization

You can start small:

  • Use the dashboard's table of contents and search
  • Explore anomaly scoring ("AR" toggle)
  • Create custom dashboards in Netdata Cloud

Docs and guides

No. Netdata Cloud is optional.

Netdata works without it, but with Cloud you can:

  • Access remotely with SSO
  • Save dashboard customizations
  • Configure alerts centrally
  • Collaborate with role-based access

Anonymous telemetry helps improve the product. You can disable it:

  • Add --disable-telemetry to the installer, or
  • Create /etc/netdata/.opt-out-from-anonymous-statistics and restart Netdata

Telemetry helps us understand usage, not track users. No private data is collected.

You'll join users including:

  • Major companies (Amazon, ABN AMRO Bank, Facebook, Google, IBM, Intel, Netflix, Samsung)
  • Universities (NYU, Columbia, Seoul National, UCL)
  • Government organizations worldwide
  • Infrastructure-intensive organizations
  • Technology operators
  • Startups and freelancers
  • SysAdmins and DevOps professionals

:book: Documentation

Visit Netdata Learn for full documentation and guides.

Shortened here. Read the whole README on GitHub.

Signals

GitHub stars
81k
Forks
7k
Last commit
Oct 2026

Questions

What is Netdata MCP?
Netdata MCP is an MCP server that gives an AI agent access to Netdata monitoring data: live metrics, logs, alerts, and ML-based anomaly detection.
What can the agent do with the Netdata MCP server?
The agent can view live server metrics, read logs, check alerts, and see anomaly detection results from the connected Netdata instance.
Does it support real-time monitoring?
Yes. The server provides real-time infrastructure monitoring data, including metrics, logs, alerts, and anomalies.
Do I need a Netdata instance already running?
Yes. The MCP server connects to Netdata, so a reachable Netdata instance must be running before the agent can use it.
Can the agent change monitoring settings?
The item describes viewing metrics, logs, alerts, and anomalies. It does not state that the agent can change Netdata configuration or settings.
Advanced
Delivery
Netdata MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-netdata-mcp-server
Source
github.com/netdata/netdata
Hosted endpoint
https://app.netdata.cloud/api/v1/mcp