Skip to content

docs: Clarify Cloud MCP telemetry queries do not consume AI credits - #23381

Draft
nedi-app[bot] wants to merge 2 commits into
masterfrom
docs/netdata-cloud-homelab-ai-credits-mcp-usage
Draft

docs: Clarify Cloud MCP telemetry queries do not consume AI credits#23381
nedi-app[bot] wants to merge 2 commits into
masterfrom
docs/netdata-cloud-homelab-ai-credits-mcp-usage

Conversation

@nedi-app

@nedi-app nedi-app Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Clarify Cloud MCP telemetry queries do not consume AI credits. Files changed: docs/netdata-ai/mcp/README.md.

User Request

I’m evaluating the Homelab plan specifically for AI-driven operations using the Cloud MCP with an external AI agent (Devin IDE), not for human dashboard use. 1. How many AI credits are included with the Homelab plan each month? 2. Which MCP operations consume AI credits? 3. Do...

Prompt (English)

Clarification of how AI credits work on the Homelab plan when using the Cloud MCP server with an external AI agent (Devin IDE) for telemetry queries and AI investigations

Reason for Change

This change applies the specific user request using repository-truth evidence from the audit execution workspace.


Summary by cubic

Clarified in docs/netdata-ai/mcp/README.md that Cloud MCP telemetry queries do not consume Netdata AI credits; only built-in, server-side AI features do. Also noted that any paid plan (including Homelab) can use Cloud MCP with an API token scoped to scope:mcp, and it continues to work even if AI credits run out.

Written for commit da9f7ae. Summary will update on new commits.

Review in cubic

nedi-app Bot added 2 commits August 3, 2026 12:07
…ta Cloud MCP README clarifying that Cloud MCP telemetry queries (metrics, alerts, logs, nodes, functions) do not consume Netdata AI credits because the external AI client performs all reasoning and Netdata runs no server-side AI for MCP requests. The section states AI credits meter only built-in server-side AI (Conversations, Investigations, Insights) and cross-links those docs for credit mechanics; confirms any Paid plan (Homelab, Business, Enterprise On-Premise) can use Cloud MCP without needing credits; and documents that Cloud MCP keeps working for telemetry queries regardless of AI credit balance. The plan's assertion that built-in AI credits are 'Business/Free Trial only, not Homelab' was omitted because it is directly contradicted by alerts-automation.md (which grants credits on 'a paid plan'); per-plan built-in AI credit counts/availability are deferred to the cross-linked feature docs and pricing page instead of asserting a contradicted rule.
@nedi-app nedi-app Bot added the nedi-audit PRs created by the nedi-audit pipeline label Aug 3, 2026
@sonarqubecloud

sonarqubecloud Bot commented Aug 3, 2026

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs nedi-audit PRs created by the nedi-audit pipeline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants