Charles MCP Server

Instructions

Implementation Reference

• charles_mcp/tools/reset.py:71-79 (handler)

  The list_sessions tool implementation, which lists historical session files.

  async def list_sessions(ctx: ToolContext) -> list[dict]:
      """List historical session files via the legacy tool name."""
      logger.info("Tool called: list_sessions()")
      deps = get_tool_dependencies(ctx)
  
      recordings = deps.history_service.list_recordings_result()
      if not recordings.items:
          return [{"message": "No recordings available"}]
      return [item.model_dump() for item in recordings.items]