Update MCP Registry entry with Cloud MCP endpoint (#21747)
- Update schema from 2025-10-17 to 2025-12-11 (current) - Add Netdata Cloud MCP as primary remote endpoint (https://app.netdata.cloud/api/v1/mcp) - Remove localhost remotes (rejected by registry validator) - Remove non-standard fields (capabilities, configuration, installation, version_compatibility, support) that were silently ignored by the registry - Fix header format to use KeyValueInput (was using deprecated "type": "named" format) - Update version to 2.8.5 The previous entry was removed from the MCP curated list because it had no valid remotes or packages. This update adds the Cloud MCP endpoint as a proper streamable-http remote with bearer token authentication.
Costa Tsaousis committed
Feb 12, 2026 at 11:39 UTC
a2174fe53210e6e97f126cc92579f9f473b66bd1
1 file changed
+9
-231
server.json
+9
-231
@@ -1,9 +1,9 @@
1
{
2
- "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
"name": "io.github.netdata/mcp-server",
4
"title": "Netdata MCP Server",
5
"description": "Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.",
6
- "version": "2.7.1-1",
6
+ "version": "2.8.5",
7
"websiteUrl": "https://www.netdata.cloud",
8
"repository": {
9
"url": "https://github.com/netdata/netdata",
@@ -13,244 +13,22 @@
13
"remotes": [
14
{
15
"type": "streamable-http",
16
- "url": "http://localhost:19999/mcp",
16
+ "url": "https://app.netdata.cloud/api/v1/mcp",
17
"headers": [
18
{
19
- "type": "named",
19
"name": "Authorization",
21
- "value": "Bearer {NETDATA_MCP_API_KEY}",
20
+ "value": "Bearer {NETDATA_CLOUD_API_TOKEN}",
21
+ "description": "Netdata Cloud API token with scope:mcp",
22
+ "isRequired": true,
23
"isSecret": true,
24
"variables": {
24
- "NETDATA_MCP_API_KEY": {
25
- "description": "Netdata MCP API key",
25
+ "NETDATA_CLOUD_API_TOKEN": {
26
+ "description": "Netdata Cloud API token (create at app.netdata.cloud > User Settings > API Tokens with scope:mcp)",
27
"isSecret": true
28
}
29
}
30
}
31
]
31
- },
32
- {
33
- "type": "sse",
34
- "url": "http://localhost:19999/mcp?transport=sse",
35
- "headers": [
36
- {
37
- "type": "named",
38
- "name": "Authorization",
39
- "value": "Bearer {NETDATA_MCP_API_KEY}",
40
- "isSecret": true,
41
- "variables": {
42
- "NETDATA_MCP_API_KEY": {
43
- "description": "Netdata MCP API key",
44
- "isSecret": true
45
- }
46
- }
47
- }
48
- ]
49
- }
50
- ],
51
- "capabilities": {
52
- "features": [
53
- "Real-time infrastructure observability",
54
- "Per-second granularity with ML anomaly detection",
55
- "System logs (systemd-journal, Windows events)",
56
- "Live system functions (processes, network connections, systemd services, ipmi)",
57
- "Alert history and transitions",
58
- "Anomaly detection, metric correlation, root cause analysis, blast radius detection"
59
- ],
60
- "transports": [
61
- "stdio (via nd-mcp bridge)",
62
- "stdio (via npx mcp-remote)",
63
- "HTTP Streamable (direct, v2.7.2+)",
64
- "SSE (direct, v2.7.2+)",
65
- "WebSocket (direct, v2.6.0+)"
66
- ]
67
- },
68
- "configuration": {
69
- "examples": {
70
- "stdio_via_nd-mcp": {
71
- "description": "Use system-installed nd-mcp bridge (all Netdata versions v2.6.0+)",
72
- "config": {
73
- "mcpServers": {
74
- "netdata": {
75
- "command": "/usr/bin/nd-mcp",
76
- "args": [
77
- "--bearer",
78
- "${NETDATA_MCP_API_KEY}",
79
- "ws://localhost:19999/mcp"
80
- ]
81
- }
82
- }
83
- },
84
- "notes": [
85
- "nd-mcp is installed with Netdata at /usr/bin/nd-mcp or /usr/sbin/nd-mcp",
86
- "Supports WebSocket transport only",
87
- "Get API key: sudo cat /var/lib/netdata/mcp_dev_preview_api_key"
88
- ]
89
- },
90
- "stdio_via_npx_mcp-remote_http": {
91
- "description": "Use official mcp-remote with HTTP transport (Netdata v2.7.2+)",
92
- "config": {
93
- "mcpServers": {
94
- "netdata": {
95
- "command": "npx",
96
- "args": [
97
- "mcp-remote@latest",
98
- "--http",
99
- "http://localhost:19999/mcp",
100
- "--allow-http",
101
- "--header",
102
- "Authorization: Bearer ${NETDATA_MCP_API_KEY}"
103
- ]
104
- }
105
- }
106
- },
107
- "notes": [
108
- "Requires Netdata v2.7.2 or later (currently in nightly builds)",
109
- "Use --allow-http for non-HTTPS connections",
110
- "For HTTPS, remove --allow-http flag"
111
- ]
112
- },
113
- "stdio_via_npx_mcp-remote_sse": {
114
- "description": "Use official mcp-remote with SSE transport (Netdata v2.7.2+)",
115
- "config": {
116
- "mcpServers": {
117
- "netdata": {
118
- "command": "npx",
119
- "args": [
120
- "mcp-remote@latest",
121
- "--sse",
122
- "http://localhost:19999/mcp",
123
- "--allow-http",
124
- "--header",
125
- "Authorization: Bearer ${NETDATA_MCP_API_KEY}"
126
- ]
127
- }
128
- }
129
- },
130
- "notes": [
131
- "Requires Netdata v2.7.2 or later (currently in nightly builds)",
132
- "SSE provides real-time streaming",
133
- "Alternative to HTTP transport"
134
- ]
135
- },
136
- "direct_http": {
137
- "description": "Direct HTTP connection (Netdata v2.7.2+, if AI client supports)",
138
- "config": {
139
- "mcpServers": {
140
- "netdata": {
141
- "type": "http",
142
- "url": "http://localhost:19999/mcp",
143
- "headers": {
144
- "Authorization": "Bearer ${NETDATA_MCP_API_KEY}"
145
- }
146
- }
147
- }
148
- },
149
- "notes": [
150
- "Requires Netdata v2.7.2 or later",
151
- "Only works if AI client supports HTTP transport directly",
152
- "No bridge needed"
153
- ]
154
- },
155
- "direct_sse": {
156
- "description": "Direct SSE connection (Netdata v2.7.2+, if AI client supports)",
157
- "config": {
158
- "mcpServers": {
159
- "netdata": {
160
- "type": "sse",
161
- "url": "http://localhost:19999/mcp?transport=sse",
162
- "headers": {
163
- "Authorization": "Bearer ${NETDATA_MCP_API_KEY}"
164
- }
165
- }
166
- }
167
- },
168
- "notes": [
169
- "Requires Netdata v2.7.2 or later",
170
- "Only works if AI client supports SSE transport directly",
171
- "No bridge needed"
172
- ]
173
- }
174
- },
175
- "authentication": {
176
- "description": "Netdata MCP uses bearer token authentication for sensitive operations (logs, live system functions)",
177
- "finding_api_key": [
178
- "Default location: /var/lib/netdata/mcp_dev_preview_api_key",
179
- "Static installations: /opt/netdata/var/lib/netdata/mcp_dev_preview_api_key",
180
- "Command: sudo cat /var/lib/netdata/mcp_dev_preview_api_key"
181
- ],
182
- "usage": [
183
- "Set environment variable: export NETDATA_MCP_API_KEY=\"$(cat /var/lib/netdata/mcp_dev_preview_api_key)\"",
184
- "Use ${NETDATA_MCP_API_KEY} in configuration files",
185
- "Or pass directly via --bearer flag (nd-mcp) or --header flag (mcp-remote)"
186
- ]
187
- },
188
- "remote_access": {
189
- "description": "To connect to remote Netdata instances, replace localhost:19999 with your Netdata IP/hostname",
190
- "examples": {
191
- "production_parent": "ws://prod-parent.example.com:19999/mcp",
192
- "staging_environment": "http://staging-netdata:19999/mcp",
193
- "cloud_instance": "https://netdata.example.com:19999/mcp"
194
- }
32
}
196
- },
197
- "installation": {
198
- "netdata": {
199
- "description": "Netdata Agent with built-in MCP server",
200
- "methods": [
201
- {
202
- "name": "Kickstart script (recommended)",
203
- "command": "wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh"
204
- },
205
- {
206
- "name": "Docker",
207
- "command": "docker run -d --name=netdata -p 19999:19999 netdata/netdata:latest"
208
- },
209
- {
210
- "name": "Package managers",
211
- "platforms": {
212
- "Ubuntu/Debian": "apt install netdata",
213
- "RHEL/CentOS": "yum install netdata",
214
- "macOS": "brew install netdata"
215
- }
216
- }
217
- ],
218
- "documentation": "https://learn.netdata.cloud/docs/netdata-agent/installation"
219
- },
220
- "nd-mcp": {
221
- "description": "stdio-to-WebSocket bridge (installed automatically with Netdata)",
222
- "locations": [
223
- "/usr/bin/nd-mcp",
224
- "/usr/sbin/nd-mcp",
225
- "/opt/netdata/usr/bin/nd-mcp (static installations)",
226
- "/usr/local/netdata/usr/bin/nd-mcp (built from source)",
227
- "C:\\Program Files\\Netdata\\usr\\bin\\nd-mcp.exe (Windows)"
228
- ],
229
- "verify": "which nd-mcp || find / -name nd-mcp 2>/dev/null"
230
- }
231
- },
232
- "version_compatibility": {
233
- "v2.6.0-v2.7.1": {
234
- "transports": [
235
- "WebSocket"
236
- ],
237
- "required_bridge": "nd-mcp",
238
- "direct_connection": false
239
- },
240
- "v2.7.2+": {
241
- "transports": [
242
- "WebSocket",
243
- "HTTP Streamable",
244
- "SSE"
245
- ],
246
- "required_bridge": "nd-mcp or mcp-remote (optional for stdio clients)",
247
- "direct_connection": true,
248
- "notes": "Currently available in nightly builds"
249
- }
250
- },
251
- "support": {
252
- "documentation": "https://learn.netdata.cloud/docs/netdata-ai/mcp",
253
- "community": "https://discord.gg/netdata",
254
- "issues": "https://github.com/netdata/netdata/issues"
255
- }
33
+ ]
34
}