mcp-local-telemetry
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-local-telemetryis it safe to run a build right now? check CPU and memory"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-local-telemetry
A lightweight Model Context Protocol server that exposes local system telemetry (CPU, RAM, Disk, top processes) to MCP-aware AI agents — Claude Code, Cursor, ChatGPT Desktop, and any other MCP client.
Written as a single-file, dependency-light Python script. Ships in under 200 lines and speaks JSON-RPC 2.0 over stdio.
Why
AI coding agents are increasingly asked to reason about the machine they are running on — "is it safe to run this build?", "what's eating CPU right now?". This server gives them a structured, protocol-standard way to ask.
Related MCP server: open-monitor
Tools
Tool | Description |
| CPU %, memory %, disk %, load average, boot time. |
| Top-N processes by CPU usage. |
Install
git clone https://github.com/Jamie643/mcp-local-telemetry.git
cd mcp-local-telemetry
python -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .Available Tools
2 toolsget_system_metricsGet System MetricsA
Returns current CPU, RAM, and Disk utilisation for the local machine. Useful for pre-flight checks before launching heavy builds, containers, or model inference.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It discloses scope ('local machine') and implies a read-only snapshot via 'Returns', but says nothing about permissions, cost, latency, or whether the values are instantaneous vs. averaged. Adequate but not rich given the zero annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight sentences with zero padding: the first defines what is returned, the second defines when to use it. Information is front-loaded and every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter, low-complexity read tool with no output schema, the description covers the essentials by naming the three metric families returned and giving a use case. It stops short of describing units, formatting, or refresh semantics, which an agent would need for precise downstream reasoning.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes no parameters and the schema is fully self-describing, so the baseline of 4 applies. The description correctly adds nothing parameter-related because there is nothing to disambiguate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Returns') and resource ('CPU, RAM, and Disk utilisation') with clear scope ('for the local machine'), so an agent immediately knows what data comes back. It does not explicitly differentiate itself from the sibling get_top_processes, but the resource distinction is implicit and clear enough.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives concrete when-to-use guidance: pre-flight checks before heavy builds, containers, or model inference. It supplies no explicit exclusions or named alternatives, which keeps it short of a 5, but the usage context is unambiguous.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_top_processesGet Top ProcessesC
Returns the N processes with the highest CPU usage.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many processes to return. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden, yet it only states the sort criterion. It doesn't say whether the result is a live snapshot or averaged, whether ties are broken deterministically, or whether privileges are required to see other users' processes.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single tight sentence with the ranking criterion front-loaded and no filler. It is efficient, though arguably too terse given the absence of annotations.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter read tool with no output schema, the core contract is covered. Still, ordering behavior and result format go unmentioned, leaving gaps that annotations would otherwise have filled.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and the single limit parameter is fully documented in the schema, so the baseline is 3. The description's 'N processes' merely restates the limit parameter without adding format or behavior detail.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb (returns), resource (processes), and ranking criterion (highest CPU usage), which is enough to tell it apart from a metrics-aggregation sibling. It stops short of explicitly naming or contrasting with get_system_metrics, so sibling differentiation is only implied.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance, no prerequisites, and no mention of the get_system_metrics alternative for aggregate CPU data. The agent must infer that this is for per-process inspection rather than system-level totals.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
2 tool updates
v0.1.0- First observed
get_system_metrics - First observed
get_top_processes
TDQS
Scored across 2 tools
get_system_metrics returns aggregate machine-level stats while get_top_processes returns per-process ranking, so their purposes are clearly distinct. An agent can trivially choose between them with no overlap.
Both tools follow a consistent get_<noun> snake_case verb_noun pattern. Naming is predictable and idiomatic throughout.
Two tools is on the thin side for a telemetry server; while each earns its place, the surface feels minimal and could reasonably include a couple more monitoring dimensions without bloat.
Core CPU/RAM/Disk and top-CPU-process coverage exists, but network I/O, memory-heavy process ranking, disk I/O, and any historical/sampling data are missing. Agents can perform basic pre-flight checks but hit dead ends for richer diagnostics.
Maintenance
Related MCP Connectors
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Analytics for MCP servers. Find out which of your tools agents get wrong. MCPulse shows you which tools AI agents retry, which come back empty, and which they never call at all. Two lines inside your own server. It never sees your arguments or your results. getmcpulse.com
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
- UnifAPIOAuthcom.unifapi
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceA real-time system diagnostics MCP server that gives AI agents live access to CPU, RAM, disk, network, processes, and hardware health metrics, with zero cloud dependency.7-
- AlicenseNot gradedqualityFmaintenanceMulti-machine system monitor with a built-in MCP server that enables AI agents to query health metrics, manage processes, schedule cron jobs, and run diagnostics across local and remote machines.133 npmApache 2.0
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to monitor real-time CPU, RAM, and disk usage on the local machine.-
- AlicenseAqualityBmaintenanceA lightweight MCP server that enables AI assistants to execute local development tools and retrieve system status with low latency over stdio or HTTP.193 npm3MIT