How to Use the Netdata MCP in VS Code Copilot

Q: Can VS Code Copilot query alerts across multiple Netdata spaces?

Yes. The agent uses listspaces to find all spaces your API token has access to, then runs listspacealerts to aggregate warnings. It presents a unified view of your infrastructure health.

Q: Does Copilot support real-time streaming of Netdata metrics?

No. Copilot queries metrics on demand using getchartdata when you ask a question. It does not run a continuous background stream, which keeps your editor fast and responsive.

Share Netdata infrastructure metrics and alert states across your entire team directly inside VS Code Copilot.

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 VS Code Copilot

Create your Vinkius account to connect Netdata to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Team-wide alert tracking in VS Code Copilot

The `list_space_alerts` tool fetches active alerts across your shared Netdata Cloud spaces. Because your team shares the configuration in Git, any developer can ask Copilot about current infrastructure health. You see production issues without leaving your workspace. Your agent uses `list_spaces` and `list_rooms` to organize alerts by environment. When an alert triggers, Copilot identifies the affected nodes and suggests the correct code repository to inspect.

Diagnostic workflows using this MCP Server

The `get_alarms` tool pulls the current status of all configured alarms on your target servers. Your agent checks this data to correlate system warnings with recent code deployments. This helps your team quickly identify if a bad commit caused an outage. This MCP Server gives your team a unified way to query infrastructure health. Copilot reads the real-time alarms and suggests immediate configuration fixes or rollback strategies.

Direct performance verification

The `get_chart_data` tool retrieves time-series performance data for any node chart. Your agent queries `list_charts` to find the correct system metrics, then pulls the numbers directly into your VS Code Copilot panel. You verify resource usage right next to your code. Developers use this to check if their local changes match production performance. By running `get_agent_info`, Copilot checks the operating system and daemon versions to ensure local test environments match production specs.

Setup guide

Set up Netdata MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Netdata MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Netdata tools listed. Try asking: "List my recent Netdata transactions" and Copilot will invoke them automatically.

.vscode/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 VS Code Copilot

Create a mcp.json file in your repository root and commit it to Git. Every developer on your team with VS Code 1.96+ and Copilot will automatically have access to the MCP tools.

Yes. The agent uses `list_spaces` to find all spaces your API token has access to, then runs `list_space_alerts` to aggregate warnings. It presents a unified view of your infrastructure health.

Your access is determined by the API token you provide. The agent can only see spaces, rooms, and nodes returned by `list_space_nodes` that your token is authorized to read.

No. Copilot queries metrics on demand using `get_chart_data` when you ask a question. It does not run a continuous background stream, which keeps your editor fast and responsive.

All communication runs through a local MCP sandbox that talks directly to the Netdata API. Your infrastructure metrics, node names, and alert configurations are never cached or used to train public models.

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