netdata-mcp-integration

Query live Netdata metrics and alerts via MCP tools.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/netdata/skills --skill netdata-mcp-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netdata-mcp-integration
Source: https://github.com/netdata/skills/tree/main/skills/netdata-mcp-integration
Command: npx skills add https://github.com/netdata/skills --skill netdata-mcp-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Verifying that instrumentation and telemetry are working in real time without manually opening dashboards can be difficult and slow.

Core Features & Use Cases

  • Live telemetry verification: list metrics, query live time-series samples, and confirm expected contexts are present.
  • Infrastructure-aware troubleshooting: correlate application signals with host-level signals and investigate anomalous/unstable metrics.
  • Alert visibility: inspect currently raised/running alerts and review alert state transitions.

Quick Start

Ask your AI coding agent to connect to Netdata MCP at http://HOST:19999/mcp (or the Netdata Cloud MCP endpoint) using your bearer token, then list the available metrics and query the latest samples for service.name equal to "checkout".

Frequently Asked Questions about netdata-mcp-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify live infrastructure telemetry using an AI coding agent?

You can verify live infrastructure telemetry by connecting an AI coding agent to the Netdata MCP server, allowing it to list metrics, query time-series data, and confirm expected contexts without manually opening dashboards.

What is the Netdata MCP server used for in telemetry verification?

The Netdata MCP server provides live proof of telemetry instrumentation by exposing tools like list_metrics and query_metrics to AI agents, enabling them to confirm metric availability and query real-time samples.

Can I use Netdata MCP to troubleshoot anomalies and inspect alert states?

Yes, Netdata MCP supports infrastructure-aware troubleshooting by allowing agents to correlate application signals with host-level metrics, investigate anomalous metrics, and inspect currently raised alerts and alert state transitions.

How do I connect an AI agent to a local Netdata Agent or Netdata Cloud via MCP?

To connect, instruct your AI coding agent to use the correct MCP endpoint shape and transport, such as http://HOST:19999/mcp or the Netdata Cloud endpoint, authenticated with a valid bearer token.

What's the best way to query live time-series samples for a specific service using Netdata MCP?

The best way to query live time-series samples is to use the Netdata MCP tools to list available metrics and query the latest data filtered by specific contexts, such as service.name equal to "checkout".

Do I need bearer-token authentication to use Netdata MCP tools?

Yes, bearer-token authentication is required to connect your AI coding agent to the Netdata MCP server and execute tools like list_metrics and query_metrics for live telemetry confirmation.