process_list
List and sort running processes by CPU or memory usage, filter by name, user, status, and thresholds, and exclude system processes for efficient system monitoring and management.
Instructions
List running processes sorted by CPU or memory with optional name, user, status, CPU/memory thresholds, system-process filtering, sort order and limit.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ctx | No | ||
| duration | No | ||
| include_system | No | ||
| limit | No | ||
| min_cpu | No | ||
| min_memory | No | ||
| name_filter | No | ||
| sort_asc | No | ||
| sort_by | No | cpu | |
| status_filter | No | ||
| user_filter | No |
Input Schema (JSON Schema)
{
"$defs": {
"Context": {
"description": "Context object providing access to MCP capabilities.\n\nThis provides a cleaner interface to MCP's RequestContext functionality.\nIt gets injected into tool and resource functions that request it via type hints.\n\nTo use context in a tool function, add a parameter with the Context type annotation:\n\n```python\n@server.tool()\ndef my_tool(x: int, ctx: Context) -> str:\n # Log messages to the client\n ctx.info(f\"Processing {x}\")\n ctx.debug(\"Debug info\")\n ctx.warning(\"Warning message\")\n ctx.error(\"Error message\")\n\n # Report progress\n ctx.report_progress(50, 100)\n\n # Access resources\n data = ctx.read_resource(\"resource://data\")\n\n # Get request info\n request_id = ctx.request_id\n client_id = ctx.client_id\n\n return str(x)\n```\n\nThe context parameter name can be anything as long as it's annotated with Context.\nThe context is optional - tools that don't need it can omit the parameter.",
"properties": {},
"title": "Context",
"type": "object"
}
},
"properties": {
"ctx": {
"anyOf": [
{
"$ref": "#/$defs/Context"
},
{
"type": "null"
}
],
"default": null
},
"duration": {
"default": 2,
"title": "Duration",
"type": "integer"
},
"include_system": {
"default": false,
"title": "Include System",
"type": "boolean"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Limit"
},
"min_cpu": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Min Cpu"
},
"min_memory": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Min Memory"
},
"name_filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name Filter"
},
"sort_asc": {
"default": false,
"title": "Sort Asc",
"type": "boolean"
},
"sort_by": {
"default": "cpu",
"enum": [
"cpu",
"memory"
],
"title": "Sort By",
"type": "string"
},
"status_filter": {
"anyOf": [
{
"enum": [
"running",
"sleeping",
"stopped",
"zombie"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Filter"
},
"user_filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "User Filter"
}
},
"title": "process_listArguments",
"type": "object"
}