How to Use the Netdata MCP in Claude

Q: Can Claude Desktop query multiple Netdata spaces at once?

Yes. Your agent runs listspaces to discover all available spaces, then iterates through them. It queries alerts across all connected environments in a single prompt.

Run Netdata commands directly from Claude Desktop to diagnose system slowdowns and check infrastructure alerts without switching to a browser.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Netdata MCP to Claude Desktop

Create your Vinkius account to connect Netdata to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Netdata with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Direct infrastructure mapping in Claude Desktop

The `list_spaces` tool pulls your entire Netdata Cloud organization hierarchy directly into your local chat interface. Your agent maps your infrastructure setup by running `list_rooms` and `list_space_nodes` to identify which machines belong to which environments. You get a clear picture of your topology instantly. Claude Desktop uses this structure to target specific systems. Instead of clicking through the web UI, you ask your agent to find a node, and it locates the machine across your rooms. It runs locally via stdio, keeping your session fast.

Real-time alert triage with this MCP Server

The `list_space_alerts` tool fetches active warnings across your entire infrastructure to catch failures before they escalate. Your agent analyzes these alerts alongside `get_alarms` to isolate which specific nodes are failing. You see the exact trigger conditions in your chat. This MCP Server allows your agent to correlate alarms across different spaces. You don't have to tail logs or watch a dashboard. Ask Claude Desktop what is broken, and it returns a prioritized list of active system alerts.

Deep-dive metric analysis

The `get_chart_data` tool extracts raw performance numbers from any active node chart for immediate debugging. Your agent queries `list_charts` to find the exact metric keys, then pulls the time-series data directly into your conversation. This eliminates the guesswork during an active incident. Claude Desktop processes these metrics to plot trends or pinpoint spikes. You can feed the output of `get_all_metrics` directly into your prompt to analyze system behavior under load. The agent handles the parsing, leaving you with clean, actionable data.

Setup guide

Set up Netdata MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Netdata MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Netdata MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under netdata-mcp.

json

{
  "mcpServers": {
    "netdata-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Netdata. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Netdata now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Netdata MCP in Claude Desktop

Open your Claude Desktop configuration file and add the server configuration under the mcpServers key. Point the command to your local executable or remote proxy. Once you save and restart the desktop app, the hammer icon in your chat window will display the new infrastructure tools.

Yes. Your agent runs `list_spaces` to discover all available spaces, then iterates through them. It queries alerts across all connected environments in a single prompt.

The integration uses standard Netdata API calls. If you run heavy queries like `get_all_metrics` too frequently, the API will throttle the requests. Ask your agent to target specific charts via `get_chart_data` to keep payload sizes small.

You can connect to either local agents or Netdata Cloud. The `get_agent_info` tool talks directly to your local instance, while space-level tools query the cloud API.

Claude Desktop runs this MCP server locally on your machine, meaning your raw performance metrics and alert states never pass through third-party servers. Your API tokens remain stored in your local configuration file. Authentication happens directly between your machine and Netdata.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript