terminal_list
Read-onlyIdempotent
View all active terminal sessions to monitor and manage multiple command-line interfaces across platforms.
Instructions
List all active terminal sessions.
Returns information about all terminal sessions that are currently
open and active.
Returns:
dict: Contains a list of terminal sessions with their details.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/terminal_mcp/server.py:185-208 (handler)The `terminal_list` function handles listing active terminal sessions by retrieving them from the `SessionManager`.
async def terminal_list() -> dict: """List all active terminal sessions. Returns information about all terminal sessions that are currently open and active. Returns: dict: Contains a list of terminal sessions with their details. """ manager = SessionManager.get_instance() sessions = await manager.list_sessions() return { "count": len(sessions), "terminals": [ { "session_id": s.id, "name": s.name, "platform": s.platform, } for s in sessions ], } - src/terminal_mcp/server.py:175-184 (registration)The tool `terminal_list` is registered using the `@mcp.tool` decorator.
@mcp.tool( name="terminal_list", annotations={ "title": "List Terminals", "readOnlyHint": True, "destructiveHint": False, "idempotentHint": True, "openWorldHint": False, }, )