Skip to main content

List

Tool Name: cpu/list

Retrieves CPU topology and architecture. See cpu/load-average for current utilization.

Example​

Every example below shows the equivalent linuxctl command and the raw MCP JSON-RPC call it resolves to. The raw call always follows the same two-step pattern (see MCP API overview for the full explanation): open an SSE stream to get a one-time POST endpoint, then POST the JSON-RPC request there - the result streams back on the SSE connection.

linuxctl
linuxctl get cpu

Output:

CPU Information (Total Processors: 4)
Vendor ID: 0x61
Model Name: 8
CPU MHz/BogoMIPS: 48.00
Cache Size: N/A
curl (raw MCP JSON-RPC)
# 1. Open the SSE stream (in the background) and capture the one-time POST endpoint
curl -N -s --cacert mcpd.crt -H "Authorization: Bearer $MCP_TOKEN" https://localhost:9091/sse &
# server sends: event: endpoint / data: /message?session_id=...

# 2. POST the tools/call request to that endpoint
curl -s --cacert mcpd.crt -X POST "https://localhost:9091/message?session_id=<from step 1>" \
-H "Authorization: Bearer $MCP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": "1", "method": "tools/call", "params": {"name": "cpu/list", "arguments": {}}}'

# 3. The result arrives on the SSE stream opened in step 1

Response:

{
"jsonrpc": "2.0",
"id": "25",
"result": {
"content": [
{
"type": "text",
"text": "CPU Information (Total Processors: 4)\nVendor ID: 0x61\nModel Name: 8\nCPU MHz/BogoMIPS: 48.00\nCache Size: N/A"
}
]
}
}